summaryrefslogtreecommitdiff
path: root/site/old_files/old_tutorials/0-installation.md
blob: 281e811f196808db186d06cd2c45433f2d8c64e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
---
description: How to install OpenDC locally, and start experimenting in no time.
---

# Installation

This page describes how to set up and configure a local single-user OpenDC installation so that you can quickly get your
experiments running. You can also use the [hosted version of OpenDC](https://app.opendc.org) to get started even
quicker (The web server is however missing some more complex features).


## Prerequisites

1. **Supported Platforms**  
   OpenDC is actively tested on Windows, macOS and GNU/Linux.
2. **Required Software**  
   A Java installation of version 19 or higher is required for OpenDC. You may download the
   [Java distribution from Oracle](https://www.oracle.com/java/technologies/downloads/) or use the distribution provided
   by your package manager.

## Download

To get an OpenDC distribution, download a recent version from our [Releases](https://github.com/atlarge-research/opendc/releases) page on GitHub.
For basic usage, the OpenDCExperimentRunner is all that is needed.

## Setup

Unpack the downloaded OpenDC distribution. Opening OpenDCExperimentRunner results in two folders, `bin` and `lib`. 
`lib` contains all `.jar` files needed to run OpenDC. `bin` two executable versions of the OpenDCExperimentRunner. 
In the following pages, we discuss how to run an experiment using the executables.