# Cylc 8 global.rc configuration location

**URL:** <https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197>\
**Category:** Cylc Support\
**Created:** [January 22, 2020, 8:14pm UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197 "2020-01-22T20:14:13Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![dtyndall](https://avatars.discourse-cdn.com/v4/letter/d/9de0a6/32.png) [@dtyndall](https://cylc.discourse.group/u/dtyndall)\
**Post date:** [January 22, 2020, 8:14pm UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/1 "2020-01-22T20:14:13Z")

</div>

Hi all,

Could anyone tell me where the global.rc file is supposed to be located for cylc 8? I’m trying to set the cylc work directory to point to our scratch disk, instead of running out of $HOME/cylc-run.

Previous versions were located in HOME/.cylc/(cylc-version)/global.rc. I tried to do the same with cylc-8, but it doesn’t seem to see it. I installed cylc-8 through conda.

Thanks,

-Dan

---

<div class="post-metadata">

**Author:** ![oliver.sanders](https://yyz2.discourse-cdn.com/free1/user_avatar/cylc.discourse.group/oliver.sanders/32/110_2.png) [@oliver.sanders](https://cylc.discourse.group/u/oliver.sanders)\
**Post date:** [January 22, 2020, 9:24pm UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/2 "2020-01-22T21:24:26Z")

</div>

Hi,

Thanks for testing Cylc8 alpha.

The work is currently at an early phase, we haven’t yet decided on where configurations are going to be stored for the different Cylc components and how that will work with multiple environments etc. For reference the open issue is here:

> <https://github.com/cylc/cylc-flow/issues/3170>
>
> Ref: #3150 (comment)
> Ping @oliver-sanders

In the mean time Cylc8 alpha is currently looking for global configuration files in the following locations:

- `/etc/cylc/flow/<version>/flow.rc`
- `$HOME/.cylc/flow/<version>/flow.rc`

The `flow.rc` is pretty much the same as the old `global.rc` with a few deprecations and tweaks (more to come).

---

<div class="post-metadata">

**Author:** ![dtyndall](https://avatars.discourse-cdn.com/v4/letter/d/9de0a6/32.png) [@dtyndall](https://cylc.discourse.group/u/dtyndall)\
**Post date:** [January 23, 2020, 2:19am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/3 "2020-01-23T02:19:54Z")

</div>

Thanks a lot Oliver–this worked.

You are welcome, but using Cylc 8 is more of a necessity for us since we need to move off of python 2 as fast as possible.

---

<div class="post-metadata">

**Author:** ![dtyndall](https://avatars.discourse-cdn.com/v4/letter/d/9de0a6/32.png) [@dtyndall](https://cylc.discourse.group/u/dtyndall)\
**Post date:** [January 23, 2020, 2:26am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/4 "2020-01-23T02:26:00Z")

</div>

By the way, is there any alpha documentation available for cylc 8?

---

<div class="post-metadata">

**Author:** ![hilary.j.oliver](https://yyz2.discourse-cdn.com/free1/user_avatar/cylc.discourse.group/hilary.j.oliver/32/4_2.png) [@hilary.j.oliver](https://cylc.discourse.group/u/hilary.j.oliver)\
**Post date:** [January 23, 2020, 4:14am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/5 "2020-01-23T04:14:02Z")

</div>

Hi Dan,

> [@dtyndall](#):
>
> By the way, is there any alpha documentation available for cylc 8?

We have a Cylc 8 version of the User Guide, which we will make available with the upcoming 8.0a2 alpha release. It does document some changes and improvements to the workflow configuration syntax, **but** a) there are actually not many of those as we are trying to maintain backward compatibility in that respect; and b) **it does not yet document the Cylc 8 architecture, how to use it, or any of the implications thereof** - which is where the really big Cylc 8 changes are.

> [@dtyndall](#):
>
> using Cylc 8 is more of a necessity for us since we need to move off of python 2 as fast as possible.

We definitely do not recommend using Cylc 8 for anything important yet, it is still undergoing heavy development and many important issues have not been addressed at this stage. Hopefully you have seen the warnings here: [https://github.com/cylc/cylc-conda/blob/master/README.md#current-limitations](https://github.com/cylc/cylc-conda/blob/master/README.md#current-limitations)

However, if you want (or need) to keep experimenting, feel free to keep asking questions here.

Note that cylc-8.0a1 was a very early release. We intend to release cylc-8.0a2 by end of January - or soon thereafter - with some major improvements. Or you can start at the bleeding edge, with git clones of all the Cylc 8 components.

The Cylc 8 User Guide, BTW, is maintained in its own repository, here: [GitHub - cylc/cylc-doc: Documentation (User Guide, Cheat Sheets, etc.) for the Cylc Workflow Engine.](https://github.com/cylc/cylc-doc)

Hilary

---

<div class="post-metadata">

**Author:** ![dtyndall](https://avatars.discourse-cdn.com/v4/letter/d/9de0a6/32.png) [@dtyndall](https://cylc.discourse.group/u/dtyndall)\
**Post date:** [January 23, 2020, 5:01am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/6 "2020-01-23T05:01:05Z")

</div>

Hilary,

Thanks for the documentation link–I figured out what the issue was. I was originally thinking that my errors might have been related to some deprecated items not being upgraded properly, but as it turns out, one of my Python functions that was written to handle some quirks of our PBS system was relying on cylc.batch\_sys\_handlers, which no longer exists. Apparently the issue that we originally had is no longer an issue for cylc 8 (hooray)!

We’ve actually been running cylc 8 continuously since mid-December to schedule background jobs, and I’ve just set it up on our HPC system which is using a PBS queue. The jobs seem to be completing ok, so I think things are fully functional.

We are a research institution, so we won’t be running anything operational with cylc 8 yet.

-Dan

---

<div class="post-metadata">

**Author:** ![hilary.j.oliver](https://yyz2.discourse-cdn.com/free1/user_avatar/cylc.discourse.group/hilary.j.oliver/32/4_2.png) [@hilary.j.oliver](https://cylc.discourse.group/u/hilary.j.oliver)\
**Post date:** [January 23, 2020, 5:30am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/7 "2020-01-23T05:30:35Z")

</div>

> [@dtyndall](#):
>
> We’ve actually been running cylc 8 continuously since mid-December

Wow, well done - that’s brilliant! 😁

Yes I should have mentioned that the back-end Cylc 8 workflow service and CLI (cylc-flow) is fully functional at Python 3 already (with some provisos, e.g. authentication needs work and authorization isn’t done at all yet). It’s mainly the new UI and associated components (Hub and UI Server) that are still evolving fast.

---

<div class="post-metadata">

**Author:** ![hilary.j.oliver](https://yyz2.discourse-cdn.com/free1/user_avatar/cylc.discourse.group/hilary.j.oliver/32/4_2.png) [@hilary.j.oliver](https://cylc.discourse.group/u/hilary.j.oliver)\
**Post date:** [January 23, 2020, 5:32am UTC](https://cylc.discourse.group/t/cylc-8-global-rc-configuration-location/197/8 "2020-01-23T05:32:40Z")

</div>

> [@dtyndall](#):
>
> cylc.batch\_sys\_handlers, which no longer exists.

In Cylc 8 use (e.g.)

```python
from cylc.flow.batch_sys_handlers.pbs import PBSHandler

```
