Octave for Debian systems: Difference between revisions

From Octave
Jump to navigation Jump to search
m (→‎Java: clean up)
(Ubuntu 24.04 renamed liboctave-dev to octave-dev)
 
(52 intermediate revisions by 20 users not shown)
Line 1: Line 1:
For Debian, and Debian-based distributions such as Ubuntu, specific solutions.
* ''This article addresses the [[:Category:Installation|installation]] and [[Building]] of GNU Octave on Debian, and Debian-based distributions such as Ubuntu.''


== Pre-compiled binaries ==
== Installing Octave ==


Binary packages for Octave and many Octave-Forge packages are provided by all versions of Debian and Ubuntu. These are the most well-tested binaries available and should work best for most users.
Binary packages for GNU Octave and many [[Octave Forge]] packages are provided by all versions of Debian and Ubuntu. These are the most well-tested binaries available and should work best for most users. To install them, run:


  sudo apt-get install octave
  sudo apt-get install octave


Aside the {{codeline|octave}} package that installs GNU Octave, other pieces of it are split over multiple packages. These are {{codeline|octave-doc}}, {{codeline|octave-info}}, and {{codeline|octave-htmldoc}} for the documentation; {{codeline|liboctave-dev}} for the octave development header files and mkoctfile (required to install Octave Forge packages); and {{codeline|octave-dbg}} for the debugging symbols.
In Debian and Ubuntu the "complete" GNU Octave software is split over multiple packages. To obtain the complete features of Octave, install additionally


For Debian stable users, there may also be newer packages available in backports, so don't forget to check there.
* {{codeline|octave-doc}}, {{codeline|octave-info}}, and {{codeline|octave-htmldoc}} for the documentation;
* {{codeline|liboctave-dev}} ({{codeline|octave-dev}} in Ubuntu 24.04) for the octave development header files and mkoctfile (required to install Octave Forge packages); and
* {{codeline|octave-dbg}} for the debugging symbols.


=== Octave packages ===
Many Octave packages are also distributed by Debian and Ubuntu.  These are tested to work the best with the respective Octave version.  Install them via:
 
Many Octave packages are also distributed by your Linux distribution.  These are tested to work the best with your Octave version.  For example:


  sudo apt-get install octave-control octave-image octave-io octave-optim octave-signal octave-statistics
  sudo apt-get install octave-control octave-image octave-io octave-optim octave-signal octave-statistics


=== Octave's Personal Package Archive (PPA) for Ubuntu ===
Up to 2018, the [https://launchpad.net/~octave GNU Octave Team] on Launchpad actively maintained a PPA providing more up to date packages of Octave. These were backported from Debian unstable and were useful for older Ubuntu installations (up to Xenial Xerus 16.04). To set up your system to install these packages, run:
 
For some Ubuntu releases the octave packages are too old (Ubuntu 12.04 only has Octave version 3.2).  The [https://launchpad.net/~octave GNU Octave Team] on Launchpad maintains a PPA providing more up to date packages of Octave for all versions of Ubuntu. These are backported from Debian unstable (the Ubuntu Octave Team needs help testing and preparing the packages so if you can help with this, contact [[User:Mtmiller|Mike Miller]]). To set up your system to install these packages:


  sudo apt-add-repository ppa:octave/stable
  sudo apt-add-repository ppa:octave/stable
Line 25: Line 23:
  sudo apt-get install octave
  sudo apt-get install octave


== Compiling from source ==
== Building Octave from source ==


The ''only'' tricky part is to install the dependencies. Once that is solved, installing from source should be as easy as {{Codeline|./configure && make && make install}}. See the manual for [http://www.gnu.org/software/octave/doc/interpreter/Running-Configure-and-Make.html configure options] and [[Octave_for_Debian_systems#Configuration|below]] for some common examples.
: ''For general build instructions, see [[Building]].''
 
The ''only'' tricky part is to install the Octave build dependencies. Once that is solved, one can easily follow the [[Building|general build instructions]]. See [[#Configuration|below]] for some Debian and Ubuntu specific configuration options.


=== Install dependencies ===
=== Install dependencies ===
Line 42: Line 42:
* may install packages that are no longer octave dependencies.
* may install packages that are no longer octave dependencies.


==== The even easier way (but experimental) ====
==== The right way ====


The [[MXE|MXE-octave]] package provides a way to compile Octave for different platforms. Dependencies and certain flags are handled automatically.
The right way is to install all the dependencies listed on the [[Building#Dependencies|Building]] wiki page.  One can either search for the respective packages manually on


==== The right way ====
* https://packages.debian.org
* https://packages.ubuntu.com
 
or, for the sake of convenience, use some "one-liner" to install them:
 
* '''Ubuntu 24.04 (LTS)'''
 
:<pre>sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre2-dev libqhull-dev libqscintilla2-qt5-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-11-jdk perl portaudio19-dev pstoedit qtbase5-dev qttools5-dev qttools5-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev</pre>
 
Or to build the GUI with Qt6 (Octave 9 or later):
:<pre>sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre2-dev libqhull-dev libqscintilla2-qt6-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-11-jdk perl portaudio19-dev pstoedit qt6-5compat-dev qt6-base-dev qt6-tools-dev qt6-base-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev</pre>
 
(Some of these packages might only be needed when building from a repository checkout.)
 
* '''Ubuntu 22.04 (LTS)'''
 
:<pre>sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libbison-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre3-dev libqhull-dev libqscintilla2-qt5-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-8-jdk perl portaudio19-dev pstoedit qtbase5-dev qttools5-dev qttools5-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev</pre>
 
(Some of these packages might only be needed when building from a repository checkout.)
 
* '''Ubuntu 20.04 (LTS)'''
 
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-dev openjdk-11-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libsuitesparse-dev texlive-latex-extra libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsundials-dev rapidjson-dev</pre>
 
[[User:KaKiLa|KaKiLa]] ([[User talk:KaKiLa|talk]]) 03:34, 17 June 2020 (PDT) lpr conflict with cups-bsd
 
* '''Ubuntu 19.10'''
 
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libsuitesparse-dev texlive-latex-extra texlive-libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsundials-dev</pre>
 
* '''Ubuntu 18.04 (LTS)'''
 
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libsuitesparse-dev texlive texlive-generic-recommended libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev</pre>
 
* '''Ubuntu 16.04 (LTS)'''
 
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>


The right way is to select and install all the dependencies as listed in the {{Path|INSTALL.OCTAVE}} file. The following are their package names in Debian repositories (they will have their own dependencies which your package manager will solve automatically). If you are building development versions, you'll require some more packages as listed on {{Path|etc/HACKING}} and {{Path|INSTALL}}. Many of them will already be installed on your system. Install the dependencies by typing
* '''Debian 10'''


sudo apt-get install
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-dev openjdk-11-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libjack-jackd2-dev libqhull-dev libqrupdate-dev libqt5core5a qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsuitesparse-dev texlive texlive-latex-extra libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar libsundials-dev git</pre>


followed by the package names of the table below.
* '''Debian 9'''


:{| class="wikitable"
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libjack-jackd2-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>
|-
! Dependency        !! Debian 8 Jessie (stable)            !! Ubuntu 14.04 Trusty Tahr (LTS)
|-
!colspan="3" style="text-align:center;" | Required build tools
|-
| C compiler
|| [https://packages.debian.org/jessie/gcc gcc]
|| [http://packages.ubuntu.com/trusty/gcc gcc]
|-
| C++ compiler
|| [https://packages.debian.org/jessie/g++ g++]
|| [http://packages.ubuntu.com/trusty/g++ g++]
|-
| Fortran compiler
|| [https://packages.debian.org/jessie/gfortran gfortran]
|| [http://packages.ubuntu.com/trusty/gfortran gfortran]
|-
| GNU make
|| [https://packages.debian.org/jessie/make make]
|| [http://packages.ubuntu.com/trusty/make make]
|-
!colspan="3" style="text-align:center;"| Required external packages
|-
| BLAS
|| [https://packages.debian.org/jessie/libblas-dev libblas-dev]
|| [http://packages.ubuntu.com/trusty/libblas-dev libblas-dev]
|-
| LAPACK
|| [https://packages.debian.org/jessie/liblapack-dev liblapack-dev]
|| [http://packages.ubuntu.com/trusty/liblapack-dev liblapack-dev]
|-
| PCRE
|| [https://packages.debian.org/jessie/libpcre3-dev libpcre3-dev]
|| [http://packages.ubuntu.com/trusty/libpcre3-dev libpcre3-dev]
|-
!colspan="3"  style="text-align:center;"| ''Strongly'' recommended. Check the [http://www.gnu.org/software/octave/doc/interpreter/External-Packages.html Octave manual] for more information.
|-
| ARPACK
|| [https://packages.debian.org/jessie/libarpack2-dev libarpack2-dev]
|| [http://packages.ubuntu.com/trusty/libarpack2-dev libarpack2-dev]
|-
| cURL
|| [https://packages.debian.org/jessie/libcurl4-gnutls-dev libcurl4-gnutls-dev]
|| [http://packages.ubuntu.com/trusty/libcurl4-gnutls-dev libcurl4-gnutls-dev]
|-
| epstool
|| [https://packages.debian.org/jessie/epstool epstool]
|| [http://packages.ubuntu.com/trusty/epstool epstool]
|-
| FFTW3
|| [https://packages.debian.org/jessie/libfftw3-dev libfftw3-dev]
|| [http://packages.ubuntu.com/trusty/libfftw3-dev libfftw3-dev]
|-
| fig2dev
|| [https://packages.debian.org/jessie/transfig transfig]
|| [http://packages.ubuntu.com/trusty/transfig transfig]
|-
| FLTK
|| [https://packages.debian.org/jessie/libfltk1.3-dev libfltk1.3-dev]
|| [http://packages.ubuntu.com/trusty/libfltk1.3-dev libfltk1.3-dev]
|-
| fontconfig
|| [https://packages.debian.org/jessie/libfontconfig1-dev libfontconfig1-dev]
|| [http://packages.ubuntu.com/trusty/libfontconfig1-dev libfontconfig1-dev]
|-
| FreeType
|| [https://packages.debian.org/jessie/libfreetype6-dev libfreetype6-dev]
|| [http://packages.ubuntu.com/trusty/libfreetype6-dev libfreetype6-dev]
|-
| gl2ps
|| [https://packages.debian.org/jessie/libgl2ps-dev libgl2ps-dev]
|| [http://packages.ubuntu.com/trusty/libgl2ps-dev libgl2ps-dev]
|-
| GLPK
|| [https://packages.debian.org/jessie/libglpk-dev libglpk-dev]
|| [http://packages.ubuntu.com/trusty/libglpk-dev libglpk-dev]
|-
| GNU Readline
|| [https://packages.debian.org/jessie/libreadline-dev libreadline-dev]
|| [http://packages.ubuntu.com/trusty/libreadline-dev libreadline-dev]
|-
| gnuplot
|| [https://packages.debian.org/jessie/gnuplot gnuplot]
|| [http://packages.ubuntu.com/trusty/gnuplot gnuplot-x11]
|-
| GraphicsMagick++
|| [https://packages.debian.org/jessie/libgraphicsmagick++1-dev libgraphicsmagick++1-dev]
|| [http://packages.ubuntu.com/trusty/libgraphicsmagick++1-dev libgraphicsmagick++1-dev]
|-
| HDF5
|| [https://packages.debian.org/jessie/libhdf5-serial-dev libhdf5-serial-dev]
|| [http://packages.ubuntu.com/trusty/libhdf5-serial-dev libhdf5-serial-dev]
|-
| Java JDK
|| [https://packages.debian.org/jessie/openjdk-7-jdk openjdk-7-jdk]
|| [http://packages.ubuntu.com/trusty/openjdk-7-jdk openjdk-7-jdk]
|-
| libsndfile
|| [https://packages.debian.org/jessie/libsndfile1-dev libsndfile1-dev]
|| [http://packages.ubuntu.com/trusty/libsndfile1-dev libsndfile1-dev]
|-
| LLVM
|| [https://packages.debian.org/jessie/llvm-dev llvm-dev]
|| [http://packages.ubuntu.com/trusty/llvm-dev llvm-dev]
|-
| lpr
|| [https://packages.debian.org/jessie/lpr lpr]
|| [http://packages.ubuntu.com/trusty/lpr lpr]
|-
| makeinfo
|| [https://packages.debian.org/jessie/texinfo texinfo]
|| [http://packages.ubuntu.com/trusty/texinfo texinfo]
|-
| OpenGL
|| [https://packages.debian.org/jessie/libgl1-mesa-dev libgl1-mesa-dev]
|| [http://packages.ubuntu.com/trusty/libgl1-mesa-dev libgl1-mesa-dev]
|-
| OSMesa
|| [https://packages.debian.org/jessie/libosmesa6-dev libosmesa6-dev]
|| [http://packages.ubuntu.com/trusty/libosmesa6-dev libosmesa6-dev]
|-
| pstoedit
|| [https://packages.debian.org/jessie/pstoedit pstoedit]
|| [http://packages.ubuntu.com/trusty/pstoedit pstoedit]
|-
| PortAudio
|| [https://packages.debian.org/jessie/portaudio19-dev portaudio19-dev]
|| [http://packages.ubuntu.com/trusty/portaudio19-dev portaudio19-dev]
|-
| Qhull
|| [https://packages.debian.org/jessie/libqhull-dev libqhull-dev]
|| [http://packages.ubuntu.com/trusty/libqhull-dev libqhull-dev]
|-
| QRUPDATE
|| [https://packages.debian.org/jessie/libqrupdate-dev libqrupdate-dev]
|| [http://packages.ubuntu.com/trusty/libqrupdate-dev libqrupdate-dev]
|-
| QScintilla
|| [https://packages.debian.org/jessie/libqscintilla2-dev libqscintilla2-dev]
|| [http://packages.ubuntu.com/trusty/libqscintilla2-dev libqscintilla2-dev]
|-
| Qt
||
[https://packages.debian.org/jessie/libqt4-dev libqt4-dev]
[https://packages.debian.org/jessie/libqtcore4 libqtcore4]
[https://packages.debian.org/jessie/libqtwebkit4 libqtwebkit4]
[https://packages.debian.org/jessie/libqt4-network libqt4-network]
[https://packages.debian.org/jessie/libqtgui4 libqtgui4]
[https://packages.debian.org/jessie/libqt4-opengl-dev libqt4-opengl-dev]
||
[http://packages.ubuntu.com/trusty/libqt4-dev libqt4-dev]
[http://packages.ubuntu.com/trusty/libqtcore4 libqtcore4]
[http://packages.ubuntu.com/trusty/libqtwebkit4 libqtwebkit4]
[http://packages.ubuntu.com/trusty/libqt4-network libqt4-network]
[http://packages.ubuntu.com/trusty/libqtgui4 libqtgui4]
[http://packages.ubuntu.com/trusty/libqt4-opengl-dev libqt4-opengl-dev]
|-
| SuiteSparse
|| [https://packages.debian.org/jessie/libsuitesparse-dev libsuitesparse-dev]
|| [http://packages.ubuntu.com/trusty/libsuitesparse-dev libsuitesparse-dev]
|-
| Texlive
|| texlive
|| texlive
|-
| Xft
|| [https://packages.debian.org/jessie/libxft-dev libxft-dev]
|| [http://packages.ubuntu.com/trusty/libxft-dev libxft-dev]
|-
| zlib
|| [https://packages.debian.org/jessie/zlib1g-dev zlib1g-dev]
|| [http://packages.ubuntu.com/trusty/zlib1g-dev zlib1g-dev]
|-
!colspan="3"  style="text-align:center;"|  Required to build from development sources
|-
| Autoconf
|| [https://packages.debian.org/jessie/autoconf autoconf]
|| [http://packages.ubuntu.com/trusty/autoconf autoconf]
|-
| Automake
|| [https://packages.debian.org/jessie/automake automake]
|| [http://packages.ubuntu.com/trusty/automake automake]
|-
| Bison
|| [https://packages.debian.org/jessie/bison bison]
|| [http://packages.ubuntu.com/trusty/bison bison]
|-
| Flex
|| [https://packages.debian.org/jessie/flex flex]
|| [http://packages.ubuntu.com/trusty/flex flex]
|-
| gperf
|| [https://packages.debian.org/jessie/gperf gperf]
|| [http://packages.ubuntu.com/trusty/gperf gperf]
|-
| gzip
|| [https://packages.debian.org/jessie/gzip gzip]
|| [http://packages.ubuntu.com/trusty/gzip gzip]
|-
| icoutils
|| [https://packages.debian.org/jessie/icoutils icoutils]
|| [http://packages.ubuntu.com/trusty/icoutils icoutils]
|-
| rsvg-convert
|| [https://packages.debian.org/jessie/librsvg2-bin librsvg2-bin]
|| [http://packages.ubuntu.com/trusty/librsvg2-bin librsvg2-bin]
|-
| libtool
|| [https://packages.debian.org/jessie/libtool libtool]
|| [http://packages.ubuntu.com/trusty/libtool libtool]
|-
| perl
|| [https://packages.debian.org/jessie/perl perl]
|| [http://packages.ubuntu.com/trusty/perl perl]
|-
| rsync
|| [https://packages.debian.org/jessie/rsync rsync]
|| [http://packages.ubuntu.com/trusty/rsync rsync]
|-
| tar
|| [https://packages.debian.org/jessie/tar tar]
|| [http://packages.ubuntu.com/trusty/tar tar]
|}


{{Warning|<ul><li>The Debian repositoriy has several libraries for dealing with HDF data files. The recommended is {{Codeline|libhdf5-serial-dev}}. However, the {{Forge|msh|msh package}} requires [http://www.geuz.org/gmsh/ gmsh] which is incompatible with it.</li>
* '''Debian 8'''
<li>The GraphicsMagick++ library (libgraphicsmagick++1-dev) on the Debian repositories was compiled with quantum 8 which limits reading images to 8 bit. The solution is to recompile [[GraphicsMagick]] with quantum 16 or 32 before building Octave.</li></ul>}}


=== Configuration ===
:<pre>sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-7-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar</pre>


As mentioned above, Octave can be compiled with the default settings using {{Codeline|./configure && make && make install}}. You can also tweak the setup using configure options. Some examples are given below for a Linux system.


==== 64 bit ====
{{Warning|<ul><li>The Debian repositoriy has several libraries for dealing with HDF data files. The recommended is {{Codeline|libhdf5-serial-dev}}. However, the {{Forge|msh|msh package}} requires [http://www.geuz.org/gmsh/ gmsh] which is incompatible with it.</li>
<li>The GraphicsMagick++ library (libgraphicsmagick++1-dev) on the Debian repositories was compiled with quantum 8 which limits reading images to 8 bit. The solution is to recompile [[GraphicsMagick]] with quantum 16 or 32 before building Octave.</li>
<li>For debian9 using openjdk-9-jdk (even providing  {{Codeline|JAVA_HOME}}) could *not* be used for the java interface! Use openjdk-8-jdk instead.</li>
<li>When configure decides to use QT5 instead of QT4, make might fail because lrelease is missing (see [https://savannah.gnu.org/bugs/?50580 bug 50580]).  It can be fixed by installing {{Codeline|qttools5-dev-tools}}</li>
</ul>}}


To get [https://www.gnu.org/software/octave/doc/interpreter/Compiling-Octave-with-64_002dbit-Indexing.html 64-bit] requires all linked libraries to support 64-bit variables. You can omit most of these except BLAS which gives a fatal error. This is remedied by compiling [http://www.openblas.net/ OpenBLAS] with edits to its Makefile.rule so that BINARY=64 INTERFACE64=1.
=== Configuration ===


<code>./configure LD_LIBRARY_PATH=/opt/OpenBLAS/lib CPPFLAGS=-I/opt/OpenBLAS/include LDFLAGS=-L/opt/OpenBLAS/lib --enable-64</code>
Some Debian and Ubuntu specific configure tweaks are listed below:


==== Java ====
==== Java ====


Autodetection for java should work well on Debian-based systems. A specific Java version can be specified by passing {{codeline|JAVA_HOME}} to configure, for example
Autodetection for Java should work well on Debian-based systems. A specific Java version can be specified by passing {{codeline|JAVA_HOME}} to configure, for example


  ./configure JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
./configure JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64


==== HDF5 ====
==== HDF5 ====
Line 304: Line 119:
  HDF5 library not found.  Octave will not be able to save or load HDF5 data files.
  HDF5 library not found.  Octave will not be able to save or load HDF5 data files.


The problem is that there are multiple versions of the hdf5 package.  Octave was written with the serial version in mind but it is likely to work with the others (OpenMPI and Mpich). Due to the naming scheme done in Debian, it is required to specify the location of the libraries.  See bug {{bug|38928}} for details (starting with comment #19) but basically, use the following when running configure:
The problem is that there are multiple versions of the hdf5 package.  Octave was written with the serial version in mind but it is likely to work with the others (OpenMPI and Mpich). Due to the naming scheme done in Debian, it may be required to specify the location of the libraries.  See bug {{bug|38928}} for details (starting with comment #19) but basically, use the following when running configure:
 
./configure --with-hdf5-includedir=/usr/include/hdf5/serial --with-hdf5-libdir=/usr/lib/$(dpkg-architecture -qDEB_HOST_MULTIARCH)/hdf5/serial
 
On older versions of Debian and Ubuntu, where only one flavor of the HDF5 library could be installed at a time, you may need to build Octave against one of the MPI-enabled flavors. On these older systems, configuring Octave like this may work:
 
./configure CPPFLAGS="-I/usr/include/mpi -DMPICH_SKIP_MPICXX -DOMPI_SKIP_MPICXX"
 
==== Sundials ====
 
On recent Debian and Ubuntu releases whose Sundials version (in {{codeline|libsundials-dev}}) is 3.1, a configure flag needs to be passed for {{codeline|ode15i}} and {{codeline|ode15s}} to be compiled with support for sparse Jacobians (bug {{bug|55937}}), as follows:
 
./configure CPPFLAGS="-I/usr/include/suitesparse"
 
== See also ==


  ./configure --with-hdf5-includedir=/usr/include/hdf5/serial --with-hdf5-libdir=/usr/lib/x86_64-linux-gnu/hdf5/serial
* [[MXE]] -- a more customized Octave build including many self-compiled tools.


[[Category:Building]]
[[Category:Building]]
[[Category:Installation]]
[[Category:Installation]]
[[Category:Debian]]
[[Category:GNU/Linux]]

Latest revision as of 10:51, 14 September 2024

  • This article addresses the installation and Building of GNU Octave on Debian, and Debian-based distributions such as Ubuntu.

Installing Octave[edit]

Binary packages for GNU Octave and many Octave Forge packages are provided by all versions of Debian and Ubuntu. These are the most well-tested binaries available and should work best for most users. To install them, run:

sudo apt-get install octave

In Debian and Ubuntu the "complete" GNU Octave software is split over multiple packages. To obtain the complete features of Octave, install additionally

  • octave-doc, octave-info, and octave-htmldoc for the documentation;
  • liboctave-dev (octave-dev in Ubuntu 24.04) for the octave development header files and mkoctfile (required to install Octave Forge packages); and
  • octave-dbg for the debugging symbols.

Many Octave packages are also distributed by Debian and Ubuntu. These are tested to work the best with the respective Octave version. Install them via:

sudo apt-get install octave-control octave-image octave-io octave-optim octave-signal octave-statistics

Up to 2018, the GNU Octave Team on Launchpad actively maintained a PPA providing more up to date packages of Octave. These were backported from Debian unstable and were useful for older Ubuntu installations (up to Xenial Xerus 16.04). To set up your system to install these packages, run:

sudo apt-add-repository ppa:octave/stable
sudo apt-get update
sudo apt-get install octave

Building Octave from source[edit]

For general build instructions, see Building.

The only tricky part is to install the Octave build dependencies. Once that is solved, one can easily follow the general build instructions. See below for some Debian and Ubuntu specific configuration options.

Install dependencies[edit]

Note that different Debian and Ubuntu versions may have slightly different package names but their differences should be pretty small, mostly limited to version numbers.

The easy way (but likely incorrect)[edit]

This approach is only suitable if you are building from source the same version that your Linux distribution already has packaged.

The easy way to install most of the necessary dependencies is to sudo apt-get build-dep octave. This will install all packages necessary to build and prepare a Debian package for the octave version available on your system repositories. However:

  • will install unnecessary packages related to the building of a Debian package;
  • may miss some new dependencies;
  • may install packages that are no longer octave dependencies.

The right way[edit]

The right way is to install all the dependencies listed on the Building wiki page. One can either search for the respective packages manually on

or, for the sake of convenience, use some "one-liner" to install them:

  • Ubuntu 24.04 (LTS)
sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre2-dev libqhull-dev libqscintilla2-qt5-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-11-jdk perl portaudio19-dev pstoedit qtbase5-dev qttools5-dev qttools5-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev

Or to build the GUI with Qt6 (Octave 9 or later):

sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre2-dev libqhull-dev libqscintilla2-qt6-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-11-jdk perl portaudio19-dev pstoedit qt6-5compat-dev qt6-base-dev qt6-tools-dev qt6-base-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev

(Some of these packages might only be needed when building from a repository checkout.)

  • Ubuntu 22.04 (LTS)
sudo apt install gcc g++ autoconf automake bison dvipng epstool fig2dev flex gfortran gnuplot-x11 gperf gzip icoutils libarpack2-dev libbison-dev libopenblas-dev libcurl4-gnutls-dev libfftw3-dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl1-mesa-dev libgl2ps-dev libglpk-dev libgraphicsmagick++1-dev libhdf5-dev liblapack-dev libosmesa6-dev libpcre3-dev libqhull-dev libqscintilla2-qt5-dev libqrupdate-dev libreadline-dev librsvg2-bin libsndfile1-dev libsuitesparse-dev libsundials-dev libtool libxft-dev make openjdk-8-jdk perl portaudio19-dev pstoedit qtbase5-dev qttools5-dev qttools5-dev-tools rapidjson-dev rsync tar texinfo texlive-latex-extra zlib1g-dev

(Some of these packages might only be needed when building from a repository checkout.)

  • Ubuntu 20.04 (LTS)
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-dev openjdk-11-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libsuitesparse-dev texlive-latex-extra libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsundials-dev rapidjson-dev

KaKiLa (talk) 03:34, 17 June 2020 (PDT) lpr conflict with cups-bsd

  • Ubuntu 19.10
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libsuitesparse-dev texlive-latex-extra texlive-libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsundials-dev
  • Ubuntu 18.04 (LTS)
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libsuitesparse-dev texlive texlive-generic-recommended libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev
  • Ubuntu 16.04 (LTS)
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot-x11 libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar
  • Debian 10
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev fig2dev libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-dev openjdk-11-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libjack-jackd2-dev libqhull-dev libqrupdate-dev libqt5core5a qtbase5-dev qttools5-dev qttools5-dev-tools libqscintilla2-qt5-dev libsuitesparse-dev texlive texlive-latex-extra libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar libsundials-dev git
  • Debian 9
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-8-jdk libsndfile1-dev llvm-dev texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libjack-jackd2-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar
  • Debian 8
sudo apt-get install gcc g++ gfortran make libopenblas-dev liblapack-dev libpcre3-dev libarpack2-dev libcurl4-gnutls-dev epstool libfftw3-dev transfig libfltk1.3-dev libfontconfig1-dev libfreetype6-dev libgl2ps-dev libglpk-dev libreadline-dev gnuplot libgraphicsmagick++1-dev libhdf5-serial-dev openjdk-7-jdk libsndfile1-dev llvm-dev lpr texinfo libgl1-mesa-dev libosmesa6-dev pstoedit portaudio19-dev libqhull-dev libqrupdate-dev libqscintilla2-dev libqt4-dev libqtcore4 libqtwebkit4 libqt4-network libqtgui4 libqt4-opengl-dev libsuitesparse-dev texlive libxft-dev zlib1g-dev autoconf automake bison flex gperf gzip icoutils librsvg2-bin libtool perl rsync tar


Warning icon.svg
  • The Debian repositoriy has several libraries for dealing with HDF data files. The recommended is libhdf5-serial-dev. However, the msh package requires gmsh which is incompatible with it.
  • The GraphicsMagick++ library (libgraphicsmagick++1-dev) on the Debian repositories was compiled with quantum 8 which limits reading images to 8 bit. The solution is to recompile GraphicsMagick with quantum 16 or 32 before building Octave.
  • For debian9 using openjdk-9-jdk (even providing JAVA_HOME) could *not* be used for the java interface! Use openjdk-8-jdk instead.
  • When configure decides to use QT5 instead of QT4, make might fail because lrelease is missing (see bug 50580). It can be fixed by installing qttools5-dev-tools

Configuration[edit]

Some Debian and Ubuntu specific configure tweaks are listed below:

Java[edit]

Autodetection for Java should work well on Debian-based systems. A specific Java version can be specified by passing JAVA_HOME to configure, for example

./configure JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64

HDF5[edit]

On current versions of Debian and Ubuntu, you may get the following warning when building an older version of Octave from source:

HDF5 library not found.  Octave will not be able to save or load HDF5 data files.

The problem is that there are multiple versions of the hdf5 package. Octave was written with the serial version in mind but it is likely to work with the others (OpenMPI and Mpich). Due to the naming scheme done in Debian, it may be required to specify the location of the libraries. See bug #38928 for details (starting with comment #19) but basically, use the following when running configure:

./configure --with-hdf5-includedir=/usr/include/hdf5/serial --with-hdf5-libdir=/usr/lib/$(dpkg-architecture -qDEB_HOST_MULTIARCH)/hdf5/serial

On older versions of Debian and Ubuntu, where only one flavor of the HDF5 library could be installed at a time, you may need to build Octave against one of the MPI-enabled flavors. On these older systems, configuring Octave like this may work:

./configure CPPFLAGS="-I/usr/include/mpi -DMPICH_SKIP_MPICXX -DOMPI_SKIP_MPICXX"

Sundials[edit]

On recent Debian and Ubuntu releases whose Sundials version (in libsundials-dev) is 3.1, a configure flag needs to be passed for ode15i and ode15s to be compiled with support for sparse Jacobians (bug #55937), as follows:

./configure CPPFLAGS="-I/usr/include/suitesparse"

See also[edit]

  • MXE -- a more customized Octave build including many self-compiled tools.