Difference between revisions of "Installing Inkscape"

From Inkscape Wiki
Jump to navigation Jump to search
(remove redundant info on development build)
m (Adjust layout of images)
 
(10 intermediate revisions by 4 users not shown)
Line 3: Line 3:
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]].
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 [https://inkscape.org/release/ Download webpage].
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 ===


== Installing on a Mac ==
On most Linux systems, you can use the software installer provided with your system (look for "software" in your start menu) to install Inkscape.
Please refer to the installation instructions at [https://inkscape.org/en/releases/ our web page for OS X downloads] and to the [https://inkscape.org/en/learn/faq/#Mac_OS_X_specific_issues section dedicated to OS X in our FAQ].


Visit the [https://inkscape.org/release/ Download page] to see a list of other available options and installation methods for each available version.


=== Problems After Installation ===
==== Ubuntu or Debian ====
Probably the easiest way to install on Debian/Ubuntu is to use the <code>apt</code> command.


==== (Outdated?) Keyboard mapping or Using the Alt key ====
Open a terminal and type:
  sudo apt-get update
  sudo apt-get install inkscape


Create or edit the file ~/.Xmodmap with:
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.


  ! To make Alt keys "work" again.
==== Ubuntu (new stable versions) ====
  keycode 66 = Alt_L
  clear Mod1
  add Mod1 = Alt_L
  ! The right Alt key is already mapped to Mode_switch (at least on my box). Uncomment the next line, if it's mapped differently on your Mac.
  ! keycode 69 = Mode_switch
  clear Mod2
  add Mod2 = Mode_switch


''X11'' > ''Preferences'' > Disable "'''Use the system keyboard layout'''" and "'''Enable keyboard shortcuts under X11'''" options
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:


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


==== (Outdated?) Copy & Paste doesn't work well with Inkscape objects ====
==== openSUSE ====


''X11'' > ''Preferences'' > Disable "'''Update Pasteboard when CLIPBOARD changes'''" options
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.


== 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.


== Installing on Linux ==
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.
 
On most Linux systems, you can use the software installer provided with your system (look for "software" in your start menu) to install Inkscape.
 
=== Ubuntu or Debian Linux ===
Probably the easiest way to install on Debian/Ubuntu is to use the apt command.  
 
Open a terminal and type;
  sudo apt-get update (enter)
  sudo apt-get install inkscape (enter)
 
If your Ubuntu version does not have the most current Inkscape version in its repositories (yet), you can use the [https://launchpad.net/~inkscape.dev/+archive/ubuntu/stable stable ppa] to get the latest stable Inkscape release.
 
==== Ubuntu Linux Development Versions ====
 
Development versions (inkscape-trunk) are available from our [https://launchpad.net/~inkscape.dev/+archive/ubuntu/trunk trunk ppa] for Ubuntu and derivative Linux distributions.


'''Note:''' Development versions offer some nice new features, but can be somewhat unstable, so save often. Inexperienced users will also quite possibly have problems installing them.
'''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>.


=== openSUSE ===
=== '''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.


openSUSE includes Inkscape in the Gnome repositories. The newest version of Inkscape releases is in Gnome:Apps.
=== 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.


'''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>.


== Installing on a Windows system ==
==== Ubuntu ====
=== Stable version ===
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/ .
You can find the installer on the [http://www.inkscape.org/release/ download page]. Normally you want to choose "64-bit architecture" and "MSI package". Installing should be an easy step-by-step (next-next-finish) process.


=== Unstable development version===
=== Windows ===
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 these steps:
=== 1. Download the latest build ===
==== 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.  
Follow the instructions on [https://inkscape.org/release/master/windows/ the 'master' branch download page] to download a 7zip file of the latest master (development) build. Save the file (inkscape-.7z) to your Downloads folder.  


==== 2. Extract the .7z archive ====
==== 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 7Z file and choose 7-Zip → Extract to "inkscape-....".
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-....".


You will get a directory which contains several files including inkscape.exe.
You will get a directory which contains several files including <code>inkscape.exe</code>.


==== 3. Run inkscape ====
==== 3. Run inkscape ====
Run the inkscape.exe file by double clicking it. That's it.  
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.
You can also drag files to inkscape.exe to have these opened.
 
'''Don't forget:''' please help Inkscape by reporting bugs, encouraging developers or fixing bugs yourself. If you find bugs, make sure to include the version (name of the 7z file, like inkscape-)


==== Multiple versions for testing ====
==== 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.
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:
# 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.)
# 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.


[[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]]

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