Using PyCharm Professional and Vagrant, how do I run a Django server?

Question

I have set up already my configuration so that it will run the server remotely. When I click run, I see the command used:

ssh://vagrant@localhost:2222/usr/bi         


        

Answer 1

The trick is creating a Python interpreter in PyCharm, and configuring the project to use this interpreter.

Note: The following applies to PyCharm Professional 4.0.

Create a Python Interpreter for Vagrant

1. Start your Vagrant machine from PyCharm by navigating to Tools->Vagrant->Up
2. SSH into your Vagrant box: Tools->Start SSH Session. Select Vagrant at [VagrantFolder] from the list that appears.
3. From the terminal that appears, run which python. This will give you an absolute path to python on your virtual machine.
4. File->Settings->Project->Project Interpreter. Click the + button to create a new one.
5. Choose Vagrant. Your Vagrant instance folder should be the location of your VagrantFile on your host machine. Python interpreter path should be set to the absolute path you found in step 3 above.
6. Click OK to save. Note: Vagrant has to be up in order for this to work.

Configure Your Project to Use the Correct Interpreter

1. From the Run menu, select Edit Configurations
2. Click + and add a new Django Server
3. Set your Host to 0.0.0.0. This will bind the runserver command to an external IP.
4. Check Run browser and set the URL to the host/port you mapped to your VM in your VagrantFile (for example, if I map my host's port 8080 to Vagrant's 8000, I'd use http://127.0.0.1:8080/)
5. Choose the Python interpreter that you set up in the above section from the Python interpreter dropdown
6. Add your absolute path mappings (this is sometimes optional, depending on where your VagrantFile is stored).
7. Click OK to save.

Run your project, and enjoy the glory that is Vagrant.