Installing Stencyl on Linux

by Jon (Updated on 2015-12-16)

Call for Help: Want to help us improve this article? Propose edits to this article.

Note: This article pertains only to Linux. On Mac and Windows, nothing extra needs to be done on your part to install Stencyl (besides running the Windows installer or dragging the app folder to the Mac's Applications directory).

Installation instructions for Ubuntu and Debian

Note: Installation on other Linux distributions will be similar, but the package names may be different. If you have trouble installing Stencyl on another Linux distribution, ask on the forums.

Minimum Requirements

  • Ubuntu 12.04 LTS or later OR Debian Jessie or later.
  • libc6 2.15 or later. (Haxe 3.0+ does not work with older versions of libc6)

Step 1 - Install the Compiler and its Dependencies

Run the following command:

sudo apt-get install g++ libgc-dev libxext-dev

Perform steps 2 and 3 only if you are on a 64-bit Linux system. If you are on a 32-bit system, you may now run Stencyl.

Step 2 - Install Packages required by the JRE and Android SDK

If you are on Debian, first add the 32-bit architecture to the package manager:

sudo dpkg --add-architecture i386
sudo apt-get update

Run the following command to install the packages needed by the JRE and the Android SDK:

sudo apt-get install libstdc++6:i386 libxtst6:i386 libXext6:i386 libxi6:i386 libncurses5:i386 libxt6:i386 libxpm4:i386 libxmu6:i386 libxp6:i386

Step 3 - Install Packages required by Flash Player

Run the following command to install the packages needed by the standalone Adobe Flash Player:

sudo apt-get install libgtk2.0-0:i386 libxt6:i386 libxext6:i386 libatk1.0-0:i386 libc6:i386 libcairo2:i386 libexpat1:i386 libfontconfig1:i386 libfreetype6:i386 libglib2.0-0:i386 libice6:i386 libpango1.0-0:i386 libpng12-0:i386 libsm6:i386 libx11-6:i386 libxau6:i386 libxcursor1:i386 libxdmcp6:i386 libxfixes3:i386 libxi6:i386 libxinerama1:i386 libxrandr2:i386 libxrender1:i386 zlib1g:i386 libnss3-1d:i386 libnspr4-0d:i386 libcurl3:i386 libasound2:i386

Step 4 - Install JDK 8 to be able to test or export to Android

Run the following command to install JDK 8 from WebUpd8 PPA:

sudo apt-add-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer

When asked by Stencyl for the location of Java, navigate and select


Installation Instructions for Arch Linux

View this page

Print Article Edit Article How to Edit an Article
Disclaimer: Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


Has anyone Else Been able to Run Stencyl, but Had Every Text in the Program replaced with: [Missing]?

0 4 years, 10 months ago
On newly installed Ubuntu 14.04 64-bit, to be able to compile my games for Android, additionally to all the steps in the tutorial, I needed also to run:
sudo apt-get install libstdc 6:i386

2 5 years, 3 months ago
Ok, Ubuntu 14.04, 32 bit, completed step one now what?

1 5 years, 4 months ago
I did get this to run on Ubuntu14.04. Followed the above 3 steps and ran it in its own directory. I'm on 64-bit.
1 5 years, 4 months ago
If you have problems installing Stencyl, please ask on the forums. The comments are not monitored by anybody and are not suitable for support.
1 5 years, 5 months ago
How can I run Stencyl on Opensuse 13.1 but I can not test any game, When I try test I get this massages:

[LOG] Running SWF: /home/wahag/stencylworks/games-gene rated/AlienApproach/Export/flash/bi n/AlienApproach.swf inside /home/wahag/Desktop/Stencyl-full/ex t-tools/players/flash-10-linux
[LOG] WARNING: environment variable G_FILENAME_ENCODING set and it is not UTF-8
[LOG] Error: Invalid SWF file name

0 5 years, 7 months ago
I had to do this:
Run the commands for the prerequisites
Download the Stencyl file
Create a folder and extract the contents into the folder
After you Extract the file into the folder you choose,
open a terminal and cd into the folder (so if it was named Stencyl you would do cd Stencyl)
then run the following command
( bash Stencyl )
That's it then it should run the installer the only thing i found is that i have to do a ( bash Stencyl ) when ever i want to start the program
can't lock it to my launcher
Hope this can help

0 5 years, 7 months ago
For everyone commenting that the instructions are not complete, please read.
Create a new directory on your desktop, named whatever you'd like. Extract the 32/64 bit download contents to that folder.
Follow steps 1-3, installing the dependencys.
When you have finished the above steps, open your new folder and simply run the "stencyl" file and the application will launch.

0 5 years, 7 months ago
Please put FINISHED instructions on how to install! I could get as far as putting it in /opt/ but im lost as far as that.
0 5 years, 7 months ago
My best guess, since these instructions are incomplete is to move the extracted contents to /opt/ add the dir to your path and create a launcher for the application so you can get it easy from the dock in Ubuntu.

Surprised these have been up for so long incomplete like this. It's like "here's the prereq's to run stencyl... Oh installing stencyl actually? good luck on th rest!"

1 5 years, 8 months ago

Sign In to Comment