704pages on
this wiki
Add New Page
Talk0 Share

Ad blocker interference detected!

Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.

Freeciv Web Client Edit

The Freeciv web client is a version of Freeciv which can be played online in a web browser, and can be found on

Freeciv-web is an open-source turn-based strategy game. It’s built entirely in HTML5 and features in-depth game-play and a wide variety of game modes and options. Your goal is to build cities, collect resources, organize your government, and build an army, with the ultimate goal of creating the best civilization. You can play online against other players (multiplayer) or play by yourself against the computer. 


Freeciv-Web Screenshot

Development Edit

The source code of Freeciv-web is developed in Github using a git distributed development model. This means that you can easily fork one of the main development repostories on github, and implement your improvement, and send a pull request to get your change accepted. These are the main git repositories for freeciv-web:

To check out the code, use the following command:

git clone

Bug reports Please submit bugreports on the Freeciv Gna project page , using the "freeciv-web" category for bugs. cazfi posted some notes in May 2012 on the state of the codebase and possibilities of reconciling it with the upstream codebase. 

More info about the source code Edit

Freeciv-web consists of five main software modules:  

  •  freeciv - a fork of the main Freeciv C client and server.
  • freeciv-proxy - a HTTP proxy which allows web client users to connect to Freeciv civservers. The proxy is a HTTP and WebSocket server, and proxy between web browsers and civservers.
  • freeciv-web - a Java web application for the Freeciv web client. This application is a AJAX application which consists of HTML,  Javascript, images and JSP files which make up the application  viewed in each user's web browser.
  • freeciv-img-extract - extracts the images of the Freeciv tileset,  and generates a version for the web. This produces a tileset PNG  and Javascript. Run this to sync with the upstream Freeciv SVN  repository.
  • publite2 - a simple way to launch multiple civservers. 

This is also a useful resource for developers interested in Freeciv-web.

Freeciv-web overview page on github

Freeciv-web on github

Setting up Freeciv-web using Vagrant on VirtualBoxEdit

Freeciv-web can be setup using Vagrant on VirtualBox to quickly create a local developer image running Freeciv-web on Ubuntu 13.10 on your host operating system such as Windows, OSX or Linux.

1. Install VirtualBox:

2. Install Vagrant:

3. Install Git: then check out Freeciv-web from git to a directory on your computer, by running these two git commands:

git config --global core.autocrlf false
git clone

4. Run Vagrant with the following commands in your Freeciv-web directory from step 3:

vagrant plugin install vagrant-vbguest
vagrant up

This will build, compile, install and run Freeciv-web on the virtual server image. Wait for the installation process to complete, watching for any error messages in the logs.

5. (Skip this step if you run Windows) For Linux or OS X, then you need to setup a SSH tunnel to port 80 like this:

sudo ssh -p 2222 -gNfL 80:localhost:80 vagrant@localhost -i ~/.vagrant.d/insecure_private_key

Then test Freeciv-web by pointing your browser to http://localhost/ on your host operating system.

To log in to your Vagrant server, run the command: vagrant ssh

Note that running Freeciv-web using Vagrant requires about 4Gb of memory and 3 Gb of harddisk space.


Freeciv-web runs on a server which is hosted based on funding from donations to the Freeciv project. So if you like this project, then please support it by donating!

Also on Fandom

Random Wiki