Skip to content

Commit

Permalink
Update docs about max-age culling, now 7 days
Browse files Browse the repository at this point in the history
  • Loading branch information
consideRatio committed Oct 19, 2023
1 parent c472816 commit 1c3d190
Showing 1 changed file with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions admin/howto/control-user-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,15 +79,24 @@ Active notebooks have their kernel killed as well.

To ensure efficient resource usage, user servers without interactive usage for a
period of time (default `1h`) are automatically stopped (via
[jupyterhub-idle-culler](https://github.com/jupyterhub/jupyterhub-idle-culler)).
This means your notebook server might be stopped for inactivity even if you have
[jupyterhub-idle-culler]).
This means your user server might be stopped for inactivity even if you have
a long running process in the notebook. This timeout can be configured.

% TODO: Add link to SRE guide on how to configure this, once it exists

Culling has the same effect as [stopping a user's server](user-server/stopping).
"Culling a user server" has the same effect as [stopping a user
server](user-server/stopping), but should be distinguished from "culling a
kernel" inside a user server. [jupyterhub-idle-culler] is only involved in
culling user servers, not culling kernels.

There is currently no maximum time limit for a user's notebook.
## Stop user servers after maximum age

As a failsafe [jupyterhub-idle-culler] is by 2i2c's defaults configured to stop
user servers that has been running for more than 7 days. This max age can be
re-configured.

[jupyterhub-idle-culler]: https://github.com/jupyterhub/jupyterhub-idle-culler

## Stop user kernels after inactivity

Expand Down

0 comments on commit 1c3d190

Please sign in to comment.