# Web-based

Instead of installing Ruby on Rails and an editor on your computer, you can use a webservice for development. All you need is a browser and an internet connection. This guide explains how to get started with [codenvy.io](https://codenvy.io/). If you’re using a different service, they may use a different wording, but the process is usually pretty similar.

## *1.* Update your browser

If you use Internet Explorer, we recommend installing [Firefox](http://guides.railsgirls.com/mozilla.org/firefox) or [Google Chrome](http://guides.railsgirls.com/google.com/chrome).

Open [whatsmybrowser.org](http://whatsmybrowser.org) and update your browser if you don’t have the latest version.

## *2.* Create an account

Go to [codenvy.io](https://codenvy.io/) and signup for free. You will need to confirm your email and then fill in your details.

![](http://guides.railsgirls.com/images/codenvy/codenvy-create-one.png)

## *3.* Setup a workspace for Ruby on Rails

The Ruby on Rails Workspace has all the software we need for the workshop already preinstalled. To create a workspace, log into [codenvy.io](https://codenvy.io/) and click on ‘Dashboard’. If no workspace has been created yet, the ‘New Workspace’ view is displayed.

![](http://guides.railsgirls.com/images/codenvy/codenvy-dashboard-create-workspace.png)

In the ‘New Workspace’ view, a few settings have to be made.

* Give the workspace a name of your choice. In the example this is “railsgirls”.
* From “Select Stack”, select “Quick Start”, scroll down and select “Rails”
* Now click on ‘Create’ to create the workspace (it takes a moment for the process to finish)

![](http://guides.railsgirls.com/images/codenvy/codenvy-rails-stack.png)

* Codenvy creates a folder ‘/projects’ during initialization, in which you can later put your code.

![](http://guides.railsgirls.com/images/codenvy/codenvy-workspace-layout.png)

## *4.* Find and restart your workspace

* If you’ve just created your project, you can probably skip these steps - they’re good to know if you login to Codenvy again later
* If you haven’t used your workspace or projects in a while, they might have been shutdown due to inactivity. You will notice an empty circle displayed next to the workspace name.

![](http://guides.railsgirls.com/images/codenvy/start-workspace.jpg)

* In this case simply click on the name of the workspace. It will then be restarted (which can take a while) and afterwards opened.
* If you have restarted a workspace, you need to run the `bundle` command again in the directory of your Rails project (you will learn more about the command in the app tutorial)

## *5.* Coding with your project

![](http://guides.railsgirls.com/images/codenvy/codenvy-layout-with-project.png)

* On the left hand side, you find a file browser where you can navigate your directories and file
* In the middle, you find the editor where you can modify your files
* At the bottom, you find the terminal where you can run commands
* Everything you need is right here in you browser window - you do not need to start an editor or terminal anywhere else
* If you are following a guide or tutorial, use the commands for Linux even if you are on a Windows computer - your operating system does not matter, since all commands are run on your project’s machine in the cloud, which is running Linux

### Starting the Rails Server

* If a guide or tutorial asks you to run a rails command that contains `rails` or `rake`, prepend `bundle exec` to this command, e. g. `bundle exec rails db:migrate`. Exception: the `rails new` command is not prefixed.
* If a guide or tutorial asks you to start the rails server with `rails server` or `rails s`, append `-b 0.0.0.0` to this command so that you run `rails server -b 0.0.0.0`
* If a guide or tutorial asks you to point your browser to something like `http://localhost:3000`, follow these instructions instead:
  * Go to ‘[Workspaces](https://codenvy.io/dashboard/#/workspaces)’ and click your running workspace&#x20;

![](https://4217153176-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFd9gifeXi3Z1c1A3kK%2F-LMYZiDznL1cHBlmxqlw%2F-LMY_c4KNUDawIqrZ0bG%2FScreen%20Shot%202018-09-16%20at%201.11.38%20PM.png?alt=media\&token=cc83a8fe-e0bc-4cfc-8b59-b5a717b7911b)

* Click 'Servers' and  copy the Address entry in the line starting with ‘server-3000-tcp

![](https://4217153176-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFd9gifeXi3Z1c1A3kK%2F-LMYZiDznL1cHBlmxqlw%2F-LMY_4K_xob2BKA4zqXz%2FScreen%20Shot%202018-09-16%20at%201.10.32%20PM.png?alt=media\&token=bfc86069-d14b-4a27-90d0-eb4231819fce)

For example, if the tutorial wants you to visit `http://localhost:3000/posts`, you would open the URL `http://node3.codenvy.io:33079/posts` instead.

![](http://guides.railsgirls.com/images/codenvy/codenvy-app-url.png)

## 6. Go through the Workshop Guides

<https://railsgirlskc.gitbook.io/workshop-guide/>
