Debian install

Linux Setup Guide < Debian install



For packaging requests or complaints, please contact the packagers.


6.0 (Squeeze - Unstable)

Official packages are available at usual mirrors so just:

sudo apt-get install spring
sudo apt-get install springlobby

will give you the latest packaged and uploaded release of spring for debian.

Debians info page for the spring packages can be found here:

The packages from unstable are usually up to date, if you always want to use the latests spring packages you should add the following line to your /etc/apt/sources.list

deb sid main

If you don't want to use unstable for your system you need to use apt pinning or add a file with the following content in /etc/apt/apt.conf.d/ (i.e. /etc/apt/apt.conf.d/99default):

APT::Default-Release "stable";

5.0 (Lenny)

Version tested:

  1. Install needed packages for compiling (as superuser or sudoer)

    aptitude install build-essential p7zip-full zlib1g-dev libfreetype6-dev libsdl1.2-dev libopenal-dev libglew-dev libdevil-dev zip libvorbis-dev libxcursor-dev libglew1.5-dev libboost1.35-dev cmake libwxgtk2.8-dev

  2. Unpack Spring tarball, cd into its directory and compile (as user)

    cd spring-directory
    cmake .

  3. Install as superuser or sudoer

    make install

  4. Unpack Spring Lobby, cd into its directory, compile and install

    cd springlobby-directory
    ./configure --disable-torrent-system --disable-sound

  5. Install as superuser or sudoer

    make install


You can install checkinstall and create a deb package by substituting make install with:

checkinstall make install

This will create a deb file along with installing it so next time you can remove it with:

dpkg -r spring-<version> springlobby

4.0 (Etch)

This is not updated for 0.76b1. Somebody check if the install succeeds for the new release this way?

This is for version 0.75b2.

We need to use Yokozar's Ubuntu package, so we need some tricks.

The --build step will take about 15 minutes. Hopefully we have precompiled binaries for etch soon too.

wget -q -O- | \
    sudo apt-key add -

wget \
    -O /etc/apt/sources.list.d/springproject.list

sudo apt-get update
sudo apt-get build-dep spring -y
sudo apt-get --build source spring -y
sudo dpkg -i spring_0.75~b2-1_i386.deb spring-data_0.75~b2-1_all.deb

If you want to install SpringLobby also, follow the instructions later on in this guide.

Your paths are: Spring executable in /usr/games/spring and read-only data in /usr/share/games/spring.

Finalizing installation

You should have Spring installed by now; if not, please see the SetupGuide.

Depending on your distribution/package, you still need a Multiplayer Lobby. For Linux, the most common one is SpringLobby, which you can get here. For Slackware 13.1, the binaries required for SpringLobby:




  • NOTE: By default, Slackware don't have *-mt libraries, so, if you want compile/run springlobby, you must make symbolic links to libboost_*.so libraries in this way:
    ##ln -s /usr/lib/ /usr/lib/


  • NOTE: If you have problems compiling/runing springlobby, you must be sure that you are using UNICODE config, to do that, you must run:
    ##wx-config --selected-config
    , and, if you have a response different to gtk2-unicode-release-2.8 you have a problem, and you must compile/install correct package.

springlobby-0.114-i686 (out of date now on v0.120)

Maps & Mods

Since Spring is only an engine, you need to download games for it, and the maps that go with those games.

SpringLobby will automatically do this for you when you attempt to join a game with a map or mod that you do not currently have, using an integrated downloader.

If you want to download it manually or browse existing maps, there are several easy to use websites:

Pick any of those sites, download a map or mod, and then double click it. This will move it to your Spring folder, using the spring map/mod installer program. If you wish to move maps/mods by hand, they are located under ~/.spring/maps/ or ~/.spring/mods/ (if the folder does not exist - create it). Do not unpack the file in any way though, just download and save it. Reload your maps/mods in SpringLobby, (Tools - Reload maps/mods) and they will be ready to use.

These sites also may provide other neat things like Lua widgets, epic replays, AI bots (for playing offline or to team up on with a friend). Generally the installation requires you to download the file and place it in the appropriate folder in your ~/.spring directory. (you may have to create the folder)

Hint: If you know the name of the map you want, there is a Search function provided in those websites. Just write a part of the name, like one word, and you will easily find the map you were looking for.

Linux specific Troubleshooting


Slow Mouse


echo '# Slow fullscreen cursor fix for Spring' >> ~/.xsessionrc
echo 'SDL_MOUSE_RELATIVE=0' >> ~/.xsessionrc
echo 'export SDL_MOUSE_RELATIVE' >> ~/.xsessionrc

And log out and log in again.

The mouse should now be as fast as in windowed mode.

Rotating Buildings

You can rotate a building before you give the build order, but the keys that do this do not work in Linux by default for some users. Issue the following commands in the beginning of the game:

/bind keycodex buildfacing inc
/bind keycodey buildfacing dec

Keycodex and keycodey above are just placeholders. What you want to write depends on which key you want to use. To see what keycodes any keys have, do:

/keydebug yes

And then hit the keys you want to use, and spring prints the keycodes in the message buffer.

If you want to save these keys you have to edit the uikeys.txt.

Problems with Audio

The engine needs at least OpenAL Soft 1.6 for its sound. If you still have the old openal-0.0.8 installed, you should update it.

Additionally, pulseaudio causes lots of issues, so try to disable it for spring if you have sound problems.

Desync in game

Spring only send the commands and not the result over the network, so it needs to run all math in a repeatable manner, so all other clients in a multiplayer match get the same results. So some CPU specific features have to enabled/disabled. If you desync, you either have a CPU that is not SSE1 capable, or you set the wrong -march/-mtune compiler flags. If you compile Spring via CMake, remove CMakeCache.txt, and leave the march flag at the default.

If You Still Have Problems

Join either IRC chat in #taspring on Freenode or #sy on QuakeNet, or ask for help in the lobby channels #sy or #springlobby.

However, generic Linux problems not really related to installing spring should be asked elsewhere.

Prepare to list your distribution, which installation method you used, and what exactly is the error.




Getting Help on IRC

Okay, so you need human help. This is how NOT to do it:

15:54 -!- **** [n=****@*] has joined #taspring
15:54 < ****> Hi, i have a problem with compiling spring on debian
15:54 < ****> can anyone help me?
15:57 -!- **** [n=****@*] has quit [Client Quit]

Do not ask to ask, instead go straight to business by stating the exact problem you have, and giving all necessary information. What you were trying to achieve, how did you try to do it, what happened and what did you expect to happen.

Then WAIT for someone to notice you.


  • #sy @ QuakeNet
  • #sy @ (with a Spring lobby client only, f.e SpringLobby)
  • #taspring @ FreeNode


Page editing toolbox

Main page
Community portal
Current events
Recent changes
Random page
View source
Editing help
This page
Discuss this page
New section
Printable version
Page history
What links here
Related changes
My pages
Log in
Special pages
New pages

Site layout created by Roflcopter et al.