Download and run the latest Euphoria setup program. It will install Euphoria
on any Windows system from Windows 95 up.
After installing, see doc\what2do.doc (or html\what2do.htm) for ideas on how
to use this package. You should also read readme.doc (or readme.htm) if you
haven't done so already.
Possible problems ...
If the install appeared to run ok, but example programs are not
working, did you remember to shut down and restart your computer?
On Windows XP/2000, be careful that your PATH and EUDIR do not conflict
with autoexec.nt, which can also be used to set environment variables.
On WinME/98/95 if the install program fails to edit your autoexec.bat
file, you will have to do it yourself. Follow the manual procedure
Euphoria can be run under DOS on older Win 3.1 systems, but we no
longer maintain an install program for this. You'll have to install
Euphoria on a newer system and then copy your EUPHORIA directory to the
old system. Set up AUTOEXEC.BAT manually on the old system as described
How to manually edit autoexec.bat (WinME/98/95/3.1)
In the file c:\autoexec.bat add C:\EUPHORIA\BIN to the list of
directories in your PATH command. You might use the MS-DOS Edit command,
Windows Notepad or any other text editor to do this.
You can also go to the Start Menu, select Run, type in sysedit and press
Enter. autoexec.bat should appear as one of the system files that you
can edit and save.
In the same autoexec.bat file add a new line:
The EUDIR environment variable indicates the full path to the main
Reboot (restart) your machine. This will define your new PATH and EUDIR
On WinNT/2000/XP and higher, if for some reason your EUDIR and PATH variables
are not set correctly, then set them in whatever way your system allows. For
example on Windows XP select: Start Menu -> Control Panel -> Performance
&Maintenance -> System -> Advanced then click the "Environment Variables"
button. Click the top "New..." button then enter EUDIR as the Variable Name
and c:\euphoria (or whatever is correct) for the value, then click OK. Find
PATH in the list of your variables, select it, then click "Edit...". Add
;c:\euphoria\bin at the end and click OK.
Some systems, such as Windows ME, have an autoexec.bat file, but it's a hidden
file that might not show up in a directory listing. Nevertheless it's there,
and you can view it and edit it if necessary by typing, for example: notepad
c:\autoexec.bat in a DOS window.
If you have an autoexec.bat file, but it doesn't contain a PATH command, you
will have to create one that includes C:\EUPHORIA\BIN.
There is another, optional, environment variable used by some experienced
users of Euphoria. It is called EUINC (see
&libDoc=on&otherDoc=on&keywords=euinc ). It determines the search path for
included files. You might want to add it, or change it, when you install a new
version of Euphoria.
WIN32 + DOS32 Note:
The setup program will give you: an interpreter for Windows (Vista/XP/NT/
2000/ME/98/95), a translator for Windows, an interpreter for DOS, a translator
for DOS, the complete Euphoria Reference Manual, the Public Domain source code,
and numerous example programs.
Simply download the setup program, e31setup.exe, and double-click it. To
complete the installation, you need to re-boot your machine.
After installing Euphoria, you will not find a Euphoria icon on your screen.
Instead you should refer to section 1.3 of the manual for the various ways of
running Euphoria programs on Windows and DOS. (After re-booting, you should be
able to double-click the .ex and .exw files in euphoria\demo, to run them.)
If you are running Euphoria on Windows-10 then you can't use ex.exe interpreter,
since Windows-10 don't support 16-bit applications. Instead, you should use
exwc.exe or exw.exe. You may need to modify some batch files, such as
"search.bat" and "ed.bat" to use exwc.exe instead of ex.exe.
How to Uninstall Euphoria
If you wish to recover your previous version of Euphoria, or parts
of it, the "backup" subdirectory contains a backup copy of each
of your previous standard Euphoria subdirectories, plus any files
that you may have added. However it does not contain any additional
subdirectories that you may have created on your own.
If there are no files that you need, you can delete the EUPHORIA
directory that you installed into.
Delete the EUDIR environment variable, and remove the EUPHORIA
directory from your PATH, either in C:\AUTOEXEC.BAT, or in
Delete the references to EUPHORIA in your Start Menu.
🗐 How to Install Euphoria on Linux or FreeBSD
Now that you've run tar to create the euphoria directory,
you need to:
add euphoria/bin to your PATH
create an environment variable: EUDIR
To view the hidden files in your home directory, type:
One or more of these files is executed when you log in.
For instance, if you have a hidden profile file such as
".bash_profile", you can edit the line:
and add euphoria/bin to it.
For example, a user called rob might do the following:
You must also add a line for the variable EUDIR such as:
And remember to export these variables, by adding this line:
export PATH EUDIR
euphoria/bin doesn't have to be first on your PATH, but if it isn't
you'll have to rename the "ed" shell script in euphoria/bin, and perhaps a
Alternatively, system administrators can put EUDIR and the PATH change
into a global file, such as /etc/profile, so many users will be able
to access the Euphoria interpreter.
Linux euphor31.tar (really .tgz) + FreeBSD note:
Right-click and choose Save Target As...
Everything you need is contained in euphor31.tar: an interpreter for Linux, a
translator for Linux, the Public Domain source code, the complete Euphoria
Reference Manual, and numerous example programs.
On Linux type:
tar -xvz -f euphor31.tar
A euphoria subdirectory will be created in the current directory. See
readme.doc and installu.doc located inside the euphoria subdirectory.
Note: the file type should really be .tgz or .tar.gz but these types cause
problems with some browsers. If you use WinZip to view or extract the files,
you must first rename "euphor31.tar" as "euphor31.tgz", or you'll get an
error... On Linux (or FreeBSD), when extracting the files using tar, the z
option is essential, unless you first decompress with: gunzip euphor31.tgz
On some Linux systems, you might need export TERM=ansi in your profile or
If your /tmp directory is not writable, or for other reasons, you may need
to use an uncompressed version of backendu. In particular, this might be
necessary on a shared Web server when you run CGI programs etc.
The instructions for FreeBSD are the same as for Linux (above), however to
install Euphoria on a FreeBSD system (with Intel CPU), use the FreeBSD
compressed tar file. It's a complete tar file for the euphoria directory and
Most of the files are the same as Linux, except for the executable files:
exu, ecu, backendu. There's also a different version of ed.ex, and the
euphoria/source files have been tweaked in a couple of places to save you time.
🗐 How to run Euphoria 3.1.1 on 64-bit Linux
When you try to run Euphoria 3.1.1 on 64-bit Linux you may get the message:
bash: ./exu: No such file or directory
This is because Euphoria 3.1.1 needs the 32-bit libraries for 64-bit Linux
So you have to install the 32-bit libraries...
On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell:
sudo apt-get install ia32-libs-multiarch
If the above does not work, type:
sudo apt-get install ia32-libs
ia32-libs-multiarch or ia32-libs are large files, since it lets you install
any other 32-bit application on 64-bit Linux system (not just Euphoria 3.1.1).
Euphoria 3.1.1 is a 32-bit programming language on all platforms:
A 64-bit Windows platform supports 32-bit applications, such as Euphoria
Euphoria 3.1.1 runs on 16-bit DOS in 32-bit protected mode, using a
built-in DOS extender.
On 64-bit Linux the user must install the 32-bit Linux libraries, as
described above. If you are running a different Linux other then "Linux
Mint", search the Internet for the command to install the 32-bit libraries
for your Linux.
For C programmers...
How to compile a c file into a 32-bit shared library,
on a 64-bit Linux (Ubuntu/Linux Mint), for Euphoria 3.1.1 open_dll():
When you try to compile 'euphoria/demo/linux/Mylib.c' into a shared library,
on a 64-bit Linux, with:
gcc -shared Mylib.c -o mylib.so
you may get the following or a similar message:
/usr/bin/ld: /tmp/cc1RfzVM.o: relocation R_X86_64_PC32 against
symbol `extra' can not be used when making a shared object;
recompile with -fPIC
/usr/bin/ld: final link failed: Bad value
collect2: error: ld returned 1 exit status
This is because gcc needs the 32-bit libraries for 64-bit Linux system.
So you have to install the gcc 32-bit libraries...
On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell:
First install gcc libraries (if not already installed):
sudo apt-get install build-essential
Install gcc 32-bit libraries:
sudo apt-get install gcc-multilib
Then use the -m32 flag to compile your file into a shared library:
gcc -m32 -shared Mylib.c -o mylib.so
Now you can run 'euphoria/demo/linux/mylib.exu' using mylib.so.