# Example step-by-step for a basic local Galaxy install with an admin account created

**URL:** <https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451>\
**Category:** Uncategorized\
**Tags:** devops-administration, galaxy-local\
**Created:** [May 30, 2019, 9:36pm UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451 "2019-05-30T21:36:48Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![aloraine](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/aloraine/32/629_2.png) [@aloraine](https://help.galaxyproject.org/u/aloraine)\
**Post date:** [May 30, 2019, 9:36pm UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/1 "2019-05-30T21:36:48Z")

</div>

Hello,

I am just getting started with developing Galaxy.

I cloned the repository onto my local computer - MacOS running High Sierra 10.13.6.

Next, I created a virtual environment, activated it, and then tried the run.sh script.

A lot of things were downloaded and installed, but then the script died with this error:

```auto
Requirement already satisfied: setuptools in ./.venv/lib/python2.7/site-packages (from sphinx==1.7.2->-r ./lib/galaxy/dependencies/dev-requirements.txt (line 32)) (41.0.1)
Unsetting $PYTHONPATH
Activating virtualenv at .venv
galaxy.tools.deps DEBUG 2019-05-30 17:32:26,193 Unable to find config file './dependency_resolvers_conf.xml'
executing: .venv/bin/uwsgi --module 'galaxy.webapps.galaxy.buildapp:uwsgi_app()' --virtualenv /Users/aloraine/galaxy/.venv --pythonpath lib --threads 4 --buffer-size 16384 --http localhost:8080 --static-map /static/style=/Users/aloraine/galaxy/static/style/blue --static-map /static=/Users/aloraine/galaxy/static --die-on-term --hook-master-start 'unix_signal:2 gracefully_kill_them_all' --hook-master-start 'unix_signal:15 gracefully_kill_them_all' --enable-threads --py-call-osafterfork 
Traceback (most recent call last):
  File ".venv/bin/uwsgi", line 6, in <module>
    from uwsgi import run
ImportError: dlopen(/Users/aloraine/galaxy/.venv/lib/python2.7/site-packages/uwsgi.so, 2): Library not loaded: /usr/local/opt/pcre/lib/libpcre.1.dylib
  Referenced from: /Users/aloraine/galaxy/.venv/lib/python2.7/site-packages/uwsgi.so
  Reason: image not found

```

The python I am running in my virtual environment (called “galaxy”):

(galaxy) $ python  
Python 2.7.10 (default, Oct 6 2017, 22:29:07)  
[GCC 4.2.1 Compatible Apple LLVM 9.0.0 (clang-900.0.31)] on darwin  
Type “help”, “copyright”, “credits” or “license” for more information.

I used pip to install wsgi in my environment, and it seems to have worked:

(galaxy) $ pip install uwsgi  
DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won’t be maintained after that date. A future version of pip will drop support for Python 2.7.  
Requirement already satisfied: uwsgi in /Users/aloraine/.virtualenvs/galaxy/lib/python2.7/site-packages (2.0.18)

Tips on what to do next would be great!

Many thanks,

Ann Loraine

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [May 31, 2019, 12:16am UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/2 "2019-05-31T00:16:53Z")

</div>

The most current Galaxy release can always be found here:  
[https://docs.galaxyproject.org/en/master/releases/index.html](https://docs.galaxyproject.org/en/master/releases/index.html)

* * *

**Example step-by-step for a basic local Galaxy install with an admin account created**

1. Go to home directory using Terminal on MAC OSX

> cd

1. Set up a place to keep the local galaxy. I often need to do testing with fresh checkouts, so tend to use the version as the dir name. Wherever you put/name this, avoid nesting the location too much, or the path will get long and possibly present with Conda errors later on (it doesn’t play well with longer paths).

> $ mkdir 1901

> $ cd 1901

1. Clone Galaxy

> $ git clone -b release\_19.01 [GitHub - galaxyproject/galaxy: Data intensive science for everyone.](https://github.com/galaxyproject/galaxy.git)

1. Let that run to completion ^^. Then go into the `galaxy` dir.

> $ cd galaxy

1. Set up the virtualenv

> $ virtualenv -p /usr/bin/python .venv

1. Initial startup of Galaxy

> $ sh run.sh

1. Then that runs using all default settings, ending with the server hosted at the local URL. Will then create my “admin” account in that web browser (but it won’t be admin yet!).

2. After that will shut it down, change the `galaxy.yml` to become admin, start it up again, and log into my account in the web browser to make sure that I set up the admin config correctly.

3. More can be done after that to customize your instance.

4. I hope this works for you, too 🙂

* * *

You probably know where these resources are, but for others reading:

- [Get Galaxy - Galaxy Community Hub](https://galaxyproject.org/admin/get-galaxy/)
- [Galaxy Deployment & Administration — Galaxy Project 23.1.1.dev0 documentation](https://docs.galaxyproject.org/en/master/admin/index.html)
- [GitHub - galaxyproject/admin-training: Galaxy Admin Training](https://github.com/galaxyproject/dagobah-training)

In particular, have a look at:

- [Framework Dependencies — Galaxy Project 23.1.1.dev0 documentation](https://docs.galaxyproject.org/en/master/admin/framework_dependencies.html)

---

<div class="post-metadata">

**Author:** ![aloraine](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/aloraine/32/629_2.png) [@aloraine](https://help.galaxyproject.org/u/aloraine)\
**Post date:** [May 31, 2019, 12:58am UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/3 "2019-05-31T00:58:41Z")

</div>

Thank you!

It is working for me now.

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [June 13, 2019, 6:52pm UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/4 "2019-06-13T18:52:25Z")

</div>

**Update going forward:**

For step 3, the release to get will update over time. Check here for the most current Git “Clone” command. And for help about how to upgrade an existing local to a new release. `19.05` is the latest now.

> **[Get Galaxy](https://galaxyproject.org/admin/get-galaxy/)**
>
> All about Galaxy and its community.

What is new in each release is in here, and also includes “upgrade” help:  
[https://docs.galaxyproject.org/en/master/releases/index.html](https://docs.galaxyproject.org/en/master/releases/index.html)

Which means that this:

> [@jennaj](#):
>
> 1. Clone Galaxy
> 
> > $ git clone -b release\_ **19.01** [GitHub - galaxyproject/galaxy: Data intensive science for everyone.](https://github.com/galaxyproject/galaxy.git)

Will as of now be:

> [@jennaj](#):
>
> 1. Clone Galaxy
> 
> > $ git clone -b release\_ **19.05** [GitHub - galaxyproject/galaxy: Data intensive science for everyone.](https://github.com/galaxyproject/galaxy.git)

And that will change over time.

---

<div class="post-metadata">

**Author:** ![Emmanuel\_Donbraye](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/emmanuel_donbraye/32/2209_2.png) [@Emmanuel\_Donbraye](https://help.galaxyproject.org/u/Emmanuel_Donbraye)\
**Post date:** [March 5, 2021, 5:28am UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/6 "2021-03-05T05:28:07Z")

</div>

Thank you so much.  
When i used your simple installation outline and ran sh run.sh on my terminal in my my Macbook, it all worked and a lot of packages were installed and it took about 12 minutes.  
However, instead of giving the correct web url, it gave all this at the end including a kill signal, all shown below

Executing: .venv/bin/uwsgi --module ‘galaxy.webapps.galaxy.buildapp:uwsgi\_app()’ --virtualenv /Users/emmanueldonbraye/galaxy/.venv --static-safe /Users/emmanueldonbraye/galaxy/client/src/assets --pythonpath lib --threads 4 --buffer-size 16384 --http localhost:8080 --static-map /static=/Users/emmanueldonbraye/galaxy/static --static-map /favicon.ico=/Users/emmanueldonbraye/galaxy/static/favicon.ico --die-on-term --hook-master-start ‘unix\_signal:2 gracefully\_kill\_them\_all’ --hook-master-start ‘unix\_signal:15 gracefully\_kill\_them\_all’ --enable-threads --umask 027 --py-call-osafterfork  
Traceback (most recent call last):  
File “.venv/bin/uwsgi”, line 5, in   
from pyuwsgi import run  
ImportError: dlopen(/Users/emmanueldonbraye/galaxy/.venv/lib/python3.8/site-packages/pyuwsgi.cpython-38-darwin.so, 2): Symbol not found: \_Py\_GetArgcArgv  
Referenced from: /Users/emmanueldonbraye/galaxy/.venv/lib/python3.8/site-packages/pyuwsgi.cpython-38-darwin.so  
Expected in: flat namespace  
in /Users/emmanueldonbraye/galaxy/.venv/lib/python3.8/site-packages/pyuwsgi.cpython-38-darwin.so  
emmanueldonbraye@Dr-Donbraye-MacBook-Pro galaxy %

How do i fix this so that galaxy will run on my system? Thanks  
I am running python 3 on Mac OS 11.2.2 (Big Sur)

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [July 23, 2022, 1:23am UTC](https://help.galaxyproject.org/t/example-step-by-step-for-a-basic-local-galaxy-install-with-an-admin-account-created/1451/7 "2022-07-23T01:23:42Z")

</div>


