This article will help you download and install the latest version of Concourse Server on your system. Concourse is super easy to setup– just download the installer, run it, and start the server! The goal is to get you up and running with an instance that is equipped with the default configuration–which works right out the box. Be sure to check out the configuration guides to see how you can tweak and tune Concourse to better fit your needs.
Download the latest release
From the terminal, navigate to the location where you wish to install Concourse Server and download the latest release
$ curl -o concourse-server.bin -L http://concoursedb.com/download/latest
Run the installer package
Once the download finishes you will have a .bin file that contains the Concourse Server distribution. Execute this installer to verify the integrity of your download and create aconcourse-server directory that contains all the Concourse Server files.
$ sh concourse-server.bin Creating directory concourse-server Verifying archive integrity... All good. Uncompressing Concourse Server................................................. Please type your administrative password to allow the installer to make some (optional) system-wide changes. WARNING: Improper use of the sudo command could lead to data loss or the deletion of important system files. Please double-check your typing when using sudo. Type "man sudo" for more information. To proceed, enter your password, or type Ctrl-C to abort. Password:
(Optional) System-wide integration
The installer will attempt to integrate Concourse Server within your entire system by installing the concourse and cash scripts to your PATH and placing log files in the /var/log/concourse directory. In order to make these changes, you’ll need to enter your administrative password when the installer prompts.
16:03:28.500 [main] INFO - Access the Concourse log files in /var/log/concourse 16:03:28.500 [main] INFO - Use 'concourse' to manage Concourse Server 16:03:28.500 [main] INFO - Use 'cash' to launch the Concourse Action SHell
If you don’t choose not to have to scripts installed to your PATH or you don’t have administrative access, you can press CTRL+C and the installer will still finish successfully.
Password: 15:58:04.500 [main] WARN - The installer couldn't place the Concourse scripts on your PATH, but you can run them directly from /path/to/concourse-server/bin. 15:58:04.500 [main] WARN - The installer couldn't place the Concourse log files in /var/log/concourse, but you can access them directly from /path/to/concourse-server/log.
Sanity check the installation
Make sure that your system is properly configured by starting Concourse server in console mode to make sure that no errors occur.
$ cd concourse-server $ ./bin/concourse console Running Concourse Server... wrapper | --> Wrapper Started as Console wrapper | Java Service Wrapper Community Edition 64-bit 3.5.22 wrapper | Copyright (C) 1999-2013 Tanuki Software, Ltd. All Rights Reserved. wrapper | http://wrapper.tanukisoftware.com wrapper | wrapper | Launching a JVM... jvm 1 | WrapperManager: Initializing... jvm 1 | _____ jvm 1 | / __ \ jvm 1 | | / \/ ___ _ __ ___ ___ _ _ _ __ ___ ___ jvm 1 | | | / _ \| '_ \ / __/ _ \| | | | '__/ __|/ _ \ jvm 1 | | \__/\ (_) | | | | (_| (_) | |_| | | \__ \ __/ jvm 1 | \____/\___/|_| |_|\___\___/ \__,_|_| |___/\___| jvm 1 | jvm 1 | Copyright (c) 2013, Cinchapi Software Collective, LLC. All Rights Reserved. jvm 1 | The Concourse server has started
Start the server
Press ctrl + c to stop the server. Now start Concourse again in background mode as a daemon process.
$ ./bin/concourse start Starting Concourse Server... Waiting for Concourse Server... . running: PID:23969
Congratulations! You now have Concourse Server up and running. You can now read and write data using CaSH or the Concourse API.
Pro Tip: You can also use the bin/start and bin/stop scripts to manage the Concourse Server lifecycle.