Difference between revisions of "Installing Inkscape"

From Inkscape Wiki
Jump to navigation Jump to search
(→‎Installing on *nix based systems: Added a section for Ubuntu)
m (Adjust layout of images)
 
(68 intermediate revisions by 18 users not shown)
Line 1: Line 1:
== Installing on a Mac ==
{{Other languages|en=Installing Inkscape}}


As well as the Inkscape [http://www.inkscape.org/download/ installation file], you will need to install X11. This is an environment that provides Unix like support for applications, including Inkscape.
This page explains how to install Inkscape, either the stable or the development version. For instructions on how to compile Inkscape from the source code, see [[Compiling Inkscape]].


A native Mac OSX version will be available sometime in the future (see [http://jo.irisson.free.fr/?p=34 here] for a sneak peek), but for now you need to do one of the following, depending on your OSX version.
The latest stable version can always be found on the [https://inkscape.org/release/ Download page]. The latest development versions are available from [https://gitlab.com/inkscape/inkscape/-/commits/master GitLab].
== Installing the stable version ==
=== '''macOS''' ===
DMG files can be downloaded from the [https://inkscape.org/release/ Download page]. Click the box labelled macOS and choose Intel or arm64 architecture. Once the download is complete, installation is the same as for any other DMG.


See also the [https://inkscape.org/learn/faq/#mac-os-x-specific-issues section dedicated to macOS in our FAQ], and the [https://inkscape-manuals.readthedocs.io/en/latest/installing-on-mac.html readthedocs] page for installation on macOS.
=== Linux ===


On most Linux systems, you can use the software installer provided with your system (look for "software" in your start menu) to install Inkscape.


'''For Panther (10.3.x):'''
Visit the [https://inkscape.org/release/ Download page] to see a list of other available options and installation methods for each available version.


You can download a suitable X11 from [http://www.apple.com/downloads/macosx/apple/macosx_updates/x11formacosx.html Apple] or mirrored [http://inkscape.modevia.com/macosx-snap/X11User_Panther.dmg here].
==== Ubuntu or Debian ====
Probably the easiest way to install on Debian/Ubuntu is to use the <code>apt</code> command.  


Open a terminal and type:
  sudo apt-get update
  sudo apt-get install inkscape


If your Ubuntu version does not have the most recent Inkscape version in its repositories (yet), the next section describes how to use the [https://launchpad.net/~inkscape.dev/+archive/ubuntu/stable stable PPA] to get it.


'''For Tiger (10.4.x):'''
==== Ubuntu (new stable versions) ====


You can install X11 from your original install DVD (for help see [http://overstimulate.com/articles/2005/11/04/installing-x11-on-os-x-10-4-tiger here]). Alternately, you can download a version for PPC [http://inkscape.modevia.com/macosx-snap/X11User_Tiger_PPC.dmg here], or Intel [http://inkscape.modevia.com/macosx-snap/X11User_Tiger_Intel.dmg here]. These files are able to be freely re-distributed as X11 is open source.
The most recent version (slightly newer than what is available directly from Ubuntu) is available from our [https://launchpad.net/~inkscape.dev/+archive/ubuntu/stable/ stable PPA] for Ubuntu and derivative Linux distributions:


'''Note:''' Once installed, you should also update your X11 to version 1.1.2 [http://www.apple.com/support/downloads/x11update2006113.html here]. This requires the earlier version, so you cannot just install the update.
<pre>
sudo add-apt-repository universe
sudo add-apt-repository ppa:inkscape.dev/stable
sudo apt-get update
sudo apt install inkscape
</pre>


==== openSUSE ====


openSUSE includes Inkscape in the Gnome repositories. The newest version of Inkscape is in Gnome:Apps.
=== Windows ===
You can find the installer on the [http://www.inkscape.org/release/ Download page]. Normally you want to choose "64-bit architecture" and "Windows Installer Package (msi)". Installing should be an easy step-by-step (next-next-finish) process.


'''For Leopard (10.5.x):'''
== Installing the development version ==
First be warned. Unstable and development mean you likely will encounter crashes, usability problems and sometimes lose data. Ctrl+S will become your friend. If you cannot take this risk, please use the stable version instead.


Leopard officially ships with a community built version of X11 called [http://trac.macosforge.org/projects/xquartz/ XQuartz] installed by default, however this version has some slight problems. In December 2007, the XQuartz community released the 2.1.1 update [http://trac.macosforge.org/projects/xquartz here]. Apple may release an officially packaged version of this update in the future.
If you are still reading, you are probably one of the brave ones who wants to be on the bleeding edge. If so, follow the steps below.


'''Don't forget:''' Please help Inkscape by reporting bugs, encouraging developers or fixing bugs yourself. If you find bugs, make sure to include the debug information which can be found in <code>Help > About</code>.


=== '''macOS''' ===
See [[Installing Inkscape#Finding development versions on GitLab|Finding development versions on GitLab]] below for instructions to download the development version, then install it in the same way as the stable version.


=== Linux ===
You can run an [https://appimage.org/ AppImage] of the latest development version on any Linux distribution. See [[Installing Inkscape#Finding development versions on GitLab|Finding development versions on GitLab]] below for instructions on how to download. To run, extract the zip and run the executable inside.


== Installing on *nix based systems ==
'''Tip:''' If you don't want to trust our executable, you can run it with sandboxing using [https://wiki.archlinux.org/title/Firejail firejail]: <code>firejail --appimage ...</code>.
 
=== using precompiled packages ===


==== Ubuntu ====
==== Ubuntu ====
Probably the easiest way to install on Ubuntu is to use the apt command.
Development versions (inkscape-trunk) are also available from our [https://launchpad.net/~inkscape.dev/+archive/ubuntu/trunk trunk PPA] for Ubuntu and derivative Linux distributions. Follow the commands at https://inkscape.org/release/inkscape-dev/gnulinux/ubuntu/ppa/dl/ .
 
Open a terminal and type;
  sudo apt-get update (enter)
  sudo apt-get install inkscape (enter)
 
==== Slackware ====
I used the [http://sourceforge.net/project/showfiles.php?group_id=93438&package_id=99112&release_id=426990 precompiled rpm] provided by Inkscape for the 0.44 release as my gcc wouldn't compile it. All you need to then do is run rpm2tgz at the command line on the package, eg "  rpm2tgz inkscape-0.44-0.i686.rpm" and then install with "installpkg inkscape-0.44-0.i686.tgz". --[[User:Pbhj|Pbhj]] 13:29, 1 July 2006 (PDT)
 
=== compiling your own ===
or
''Things to do before you install Inkscape''
 
NOTE: this isn't finished.  I currently have two screwed up systems from fooling with bleeding edge GTK+ stuff, I don't know how that happened. !! :) I'll get to the end over the next few days tho.  Setting up a more stable home network atm.
--
Tsingi
 
This was written building an InkScape snapshot on a new RedHat Linux installation.  If you find that it doesn't answer your needs exactly, please update this file when you solve your particular problem.
 
'''Installing libraries'''
 
If you are running a debian based system, and have something like synaptic that lists recent enough versions of the libraries below, use that.  If you want the latest libs, which you may need, especially if you are installing a snapshot or building from svn, you will want to download sources.  Generally you will get a ''foo.tar.bz2'' or ''foo.tar.gz'' or ''foo.tgz'' file that you will need to unpack and build.
 
''bz2'' files are the smallest.  Uncompress them first by typing ''bunzip2 foo.tar.gz'' then unpack the remaining tar file by typing ''tar -xvf foo.tar''
 
''foo.tar.gz'' files and ''foo.tgz'' files can be extracted in one operation by typing ''tar -xvzf foo.tar.gz''
 
Change to the directory that you just created ''foo''.  type ''./configure'' then ''make'' then, as root, ''make install''
 
Sometimes that is all you will need to do.
 
Sometimes you will run into dependancy errors because you need a library you haven't installed yet.  If you try installing inkscape without some of these dependancies, you will get a list of what you need.  hopefully the instructions below will help you solve these dependancies.
 
 
'''Running ldconfig'''
 
after installing libs, (as root) you need to run ''ldconfig'' so that the linker can find the libraries that you have just installed.  If you aren't logged in as root (i.e. if you became root by typing su) you may not have the /sbin/ directory in your path.  so if ''ldconfig'' isn't working for you try typing ''/sbin/ldconfig''
 
'''pkg-config'''
 
''pkg-config'' is a utility that lists dependancies for libraries that sets up flags and paths for compiling. When it's working right it's wonderful.  Getting it to work right is a pain in the ass if you don't know how.  It's amazing how silent an IRC channel will get when you mention it.
 
''pkg-config'' references pc files that applications install to give information about them.  These are called metadata files, metadata means data about data.  For a list of libraries that pkg-config sees, type ''pkg-config --list-all''  Having done that and looking at a list of pc files on my system (using ''find /usr -name "*.pc" > find.pc'', then browsing find.pc) I see that I also have a directory called ''/usr/lib64/pkgconfig/'' I might as well get that in there while I'm at it since none of those libs show up in a listing either and that's where most of them are.
 
Depending on what shell you use, there are different ways of doing this.  I'm adding a couple lines to my /etc/profile file:
 
''PKG_CONFIG_PATH=/usr/lib/pkgconfig/:/usr/share/pkgconfig/:/usr/lib64/pkgconfig/:/usr/local/lib/pkgconfig/''
 
''export PKG_CONFIG_PATH''
 
Note that I have a new 64 bit system, which is why I'm going through all this. You probably won't have a ''/usr/lib64/pkgconfig/'' unless you do too, so don't just copy what I did.  Also note that on a Windows system PATH type environment variables use semi-colons ";" for delimiters as opposed to colons ":"
 
Using bash, to immediately source the file in the shell you are using, type ''. /etc/profile'.  This won't test to see if the path gets put into your environment when open a shell though, so maybe a better thing to do is close your terminals and open new ones to see that it is actually set automagically.
 
Ahh, I can now configure glibmm.  The hair on the back of my neck is laying flat again, I think I'll have a coffee.  :)
 
----
'''libgc'''
 
download and install the latest version of libgc[[http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/]]


libgc installs in /usr/local/lib by default.  If you have installed it and it is still not linking, you may not have that in your library path.  There is a LD_LIBRARY_PATH environment variable, or alternatively you can make sure that /usr/local/lib is listed in the file /etc/ls.so.conf
=== Windows ===
----
'''libsig++'''


download and install libsig++ [http://libsigc.sourceforge.net/stable.shtml]
=== 1. Download the latest build ===
Follow the instructions on [https://inkscape.org/release/inkscape-dev/windows/ the inkscape-dev Download page] to download a 7zip file of the latest development build. Save the file (<code>inkscape-....7z</code>) to your Downloads folder.  


this should be fairly straightforward.
==== 2. Extract the .7z archive ====
----
Extract the archive using the [http://www.7-zip.org/ 7zip unpacker]: Open the Downloads folder in Explorer, right-click on the 7zip file and choose 7-Zip → Extract to "inkscape-....".
'''glibmm'''


This is where, if you haven't wrestled with pkg-config on your system you start scratching your head. Because when you run configure on glibmm you may an error like this
You will get a directory which contains several files including <code>inkscape.exe</code>.


''checking for GLIBMM... configure: error: Package requirements (sigc++-2.0 >= 2.0.0 glib-2.0 >= 2.8.0 gobject-2.0 >= 2.8.0 gmodule-2.0 >= 2.8.0) were not met. Consider adjusting the PKG_CONFIG_PATH environment variable if you
==== 3. Run inkscape ====
installed software in a non-standard prefix.''
Run the <code>inkscape.exe</code> file by double clicking it. That's it. You can also drag files to <code>inkscape.exe</code> to have these opened.


''Alternatively you may set the GLIBMM_CFLAGS and GLIBMM_LIBS environment variables to avoid the need to call pkg-config. See the pkg-config man page for
==== Multiple versions for testing ====
more details.''
For testing purposes it is good to be able to test multiple versions of Inkscape to find when and where some problem first appeared. For this reason you are able to store and use as many parallel versions of Inkscape as your disk has room for.
== Finding development versions on GitLab ==
Recent development builds can be found using the GitLab CI infrastructure. They do however require clicking through several pages to find:


It seems that most packages install in a non standard prefix, in direct defiance of everything we have been led to believe regarding the concept of standard, so you may have to deal with this. See the note on ''pkg-config'' above.
# Visit https://gitlab.com/inkscape/inkscape/-/commits/master.
----
# On the the top row of the table, click the green tick on the right. (Lower rows correspond to older versions.)
''gtkmm'' [http://www.gtkmm.org/]
# On the next page, click the left green tick under stages, and choose the version appropriate for your platform.
# On the next page, click the Download button.


----
This allows testing not just the latest development version but any earlier version, allowing bugs to be pinpointed to the version that introduced them.
(Ben) Tsingi, you are writing in the 'User Documentation' section. Most of this material is only appropriate for Developers and some would be better on the Mailing List. You will probably find that when you have finished, this page will be edited and pruned back. FWIW, I was expecting to find information about 'apt-get' (Debian) 'emerge' (Gentoo) and AutoPackage (the others).


[[File:Gitlab-download-instructions-1.png|alt=Click the green tick with alt text "Pipeline: passed/failed"|none|thumb|Step 2]]
[[File:Gitlab-download-instructions-2.png|alt=Click the leftmost green tick under "stages" with alt text "build passed:failed"|none|thumb|Step 3]]
[[File:Gitlab-download-instructions-3.png|alt=Click the download button|none||thumb|Step 4]]
[[Category:User Documentation]]
[[Category:User Documentation]]
----
'''A New Problem'''
or '''Another question to add to the FAQ Section'''
Put simply I am new to all of this 21st century stuff. I don't understand much of the jargon as English is my first and only language. I also have great learning difficulty because I don't understand any of this technical stuff, so bear with me.
I have an Apple G4 running Panther. I followed the instructions to download 'Inkscape' for Panther. I put 'Inkscape' into the 'Applications' folder as instructed.
When I tried to launch 'Inkscape' it would not start. A window appeared saying 'Get X11 for Panther'. A machine search showed that I already have 'X11' on board. I found its file path (by sheer luck): Applications/Installers/Xcode Tools/Packages/X11 SDK.pkg.
I was told to try and put a copy of 'X11' in the 'Applications' folder with 'Inkscape'. This did not work. I was told to make a new folder which only had 'Inkscape' and 'X11' in it in the 'Applications' folder. This did not work.
I have had no further advice and don't have a clue what to do next.
I have 'Inkscape' on board. I have 'X11' on board.
Addition (12th June 2007). It has been suggested that the version either of 'X11' or 'Panther' on my machine is wrong (incompatible) and that is why 'Inkscape' won't work. I don't think this is the case: 'X11' was already preloaded on the machine as indicated above and I downloaded 'Inkscape' having read the clearly shown information that it would run on a machine employing OSX 10.3 Panther. Any more thoughts are very welcome.
What next before I eat my keyboard in frustration?
Addition (14th June 2007). The story continues. Since my last edit it has been suggested that the 'X11' I have on board is not the 'X11' which works with 'Inkscape'. I was advised to visit: www.apple.com/support/downloads/x11formacosx.html where I would find the correct 'X11'. I downloaded the '.dmg' file and 'unpacked' it in my 'Applications' folder. I placed the resultant 'X11User.pkg' file in my 'Applications' folder and restarted my machine. 'Inkscape' failed to launch. The other suggestion was that I should place the 'X11User.pkg' in the 'Utilities' folder within the 'Applications' folder. This I did and restarted the machine again. This still did not work. This method did apparently work for the person who suggested it to me. I am still hopeful that I will find a solution to this problem. In the meantime I will have to devise a tasty sauce and maybe some herbs to go with my keyboard. Bon appetite!
More new information (22nd June 2007). Or, '''Another Exciting Episode''' of the 'Inkscape' saga. New revelations have come to light in the form of news that there is a specific 'Inkscape' for 'PANTHER'. '''WOW!''' All that you (dear reader) have to do is go to: sourceforge.net/project/showfiles.php?group_id=93438, then go to about the middle of the page and look for "File Releases" and download 'Inkscape-0.45.1+python-2-PANTHER.dmg'. Tune in again next week for the next seismic installment of ''''Inkscape' The Revenge'''. Coming soon to a computer near you!
Post any replys here or e-mail: cyberian@hotmail.co.uk
Thanks in advance for any help available.
----

Latest revision as of 20:30, 3 March 2023

Other languages: العربية Català Česky Deutsch English Español Français Italiano 日本語 한국어 Polski Português Português do Brasil Русский Slovenčina 中文

This page explains how to install Inkscape, either the stable or the development version. For instructions on how to compile Inkscape from the source code, see Compiling Inkscape.

The latest stable version can always be found on the Download page. The latest development versions are available from GitLab.

Installing the stable version

macOS

DMG files can be downloaded from the Download page. Click the box labelled macOS and choose Intel or arm64 architecture. Once the download is complete, installation is the same as for any other DMG.

See also the section dedicated to macOS in our FAQ, and the readthedocs page for installation on macOS.

Linux

On most Linux systems, you can use the software installer provided with your system (look for "software" in your start menu) to install Inkscape.

Visit the Download page to see a list of other available options and installation methods for each available version.

Ubuntu or Debian

Probably the easiest way to install on Debian/Ubuntu is to use the apt command.

Open a terminal and type:

 sudo apt-get update
 sudo apt-get install inkscape

If your Ubuntu version does not have the most recent Inkscape version in its repositories (yet), the next section describes how to use the stable PPA to get it.

Ubuntu (new stable versions)

The most recent version (slightly newer than what is available directly from Ubuntu) is available from our stable PPA for Ubuntu and derivative Linux distributions:

sudo add-apt-repository universe
sudo add-apt-repository ppa:inkscape.dev/stable
sudo apt-get update
sudo apt install inkscape

openSUSE

openSUSE includes Inkscape in the Gnome repositories. The newest version of Inkscape is in Gnome:Apps.

Windows

You can find the installer on the Download page. Normally you want to choose "64-bit architecture" and "Windows Installer Package (msi)". Installing should be an easy step-by-step (next-next-finish) process.

Installing the development version

First be warned. Unstable and development mean you likely will encounter crashes, usability problems and sometimes lose data. Ctrl+S will become your friend. If you cannot take this risk, please use the stable version instead.

If you are still reading, you are probably one of the brave ones who wants to be on the bleeding edge. If so, follow the steps below.

Don't forget: Please help Inkscape by reporting bugs, encouraging developers or fixing bugs yourself. If you find bugs, make sure to include the debug information which can be found in Help > About.

macOS

See Finding development versions on GitLab below for instructions to download the development version, then install it in the same way as the stable version.

Linux

You can run an AppImage of the latest development version on any Linux distribution. See Finding development versions on GitLab below for instructions on how to download. To run, extract the zip and run the executable inside.

Tip: If you don't want to trust our executable, you can run it with sandboxing using firejail: firejail --appimage ....

Ubuntu

Development versions (inkscape-trunk) are also available from our trunk PPA for Ubuntu and derivative Linux distributions. Follow the commands at https://inkscape.org/release/inkscape-dev/gnulinux/ubuntu/ppa/dl/ .

Windows

1. Download the latest build

Follow the instructions on the inkscape-dev Download page to download a 7zip file of the latest development build. Save the file (inkscape-....7z) to your Downloads folder.

2. Extract the .7z archive

Extract the archive using the 7zip unpacker: Open the Downloads folder in Explorer, right-click on the 7zip file and choose 7-Zip → Extract to "inkscape-....".

You will get a directory which contains several files including inkscape.exe.

3. Run inkscape

Run the inkscape.exe file by double clicking it. That's it. You can also drag files to inkscape.exe to have these opened.

Multiple versions for testing

For testing purposes it is good to be able to test multiple versions of Inkscape to find when and where some problem first appeared. For this reason you are able to store and use as many parallel versions of Inkscape as your disk has room for.

Finding development versions on GitLab

Recent development builds can be found using the GitLab CI infrastructure. They do however require clicking through several pages to find:

  1. Visit https://gitlab.com/inkscape/inkscape/-/commits/master.
  2. On the the top row of the table, click the green tick on the right. (Lower rows correspond to older versions.)
  3. On the next page, click the left green tick under stages, and choose the version appropriate for your platform.
  4. On the next page, click the Download button.

This allows testing not just the latest development version but any earlier version, allowing bugs to be pinpointed to the version that introduced them.

Click the green tick with alt text "Pipeline: passed/failed"
Step 2
Click the leftmost green tick under "stages" with alt text "build passed:failed"
Step 3
Click the download button
Step 4