Skip to content

Commit

Permalink
Demote cs setup
Browse files Browse the repository at this point in the history
**Problem**
Currently the website puts `cs setup` on the top item as a way of installing sbt,
however, the users seem to run into issues with `cs setup`, which is not great
for the out-of-box experience of sbt.

**Solution**
Promote more reliable way of installing sbt.
  • Loading branch information
eed3si9n committed Jan 20, 2025
1 parent 953cb4b commit 9459c8f
Showing 1 changed file with 19 additions and 17 deletions.
36 changes: 19 additions & 17 deletions src/pages/download.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@ import HomepageVersions from '@site/src/components/HomepageVersions';
Download
========

Install sbt with **cs setup**
-----------------------------
Universal packages
------------------

Follow [Install](https://www.scala-lang.org/download/) page, and install Scala using Coursier.
The most reliable way to install sbt is to use SDKMAN or manually install from the universal packages.

```bash
cs setup
sbt --script-version
```

This should install the latest stable version of `sbt`.
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip") }>sbt-{sbtVersion}.zip</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.sha256") }>sbt-{sbtVersion}.zip.sha256</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.asc") }>sbt-{sbtVersion}.zip.asc</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz") }>sbt-{sbtVersion}.tgz</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.sha256") }>sbt-{sbtVersion}.tgz.sha256</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.asc") }>sbt-{sbtVersion}.tgz.asc</a>

<Tabs groupId="operating-systems">
<TabItem value="mac" label="macOS">
Expand Down Expand Up @@ -84,15 +84,17 @@ sudo yum install sbt
</TabItem>
</Tabs>

Universal packages
------------------
Coursier (cs setup)
-------------------

- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip") }>sbt-{sbtVersion}.zip</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.sha256") }>sbt-{sbtVersion}.zip.sha256</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.asc") }>sbt-{sbtVersion}.zip.asc</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz") }>sbt-{sbtVersion}.tgz</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.sha256") }>sbt-{sbtVersion}.tgz.sha256</a>
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.asc") }>sbt-{sbtVersion}.tgz.asc</a>
:::warning
Install the latest Coursier before attempting the following steps.
There are multiple bug reports on `cs setup`. See [coursier#2953](https://github.com/coursier/coursier/issues/2953), [#7278](https://github.com/sbt/sbt/issues/7278) etc.
:::

```bash
cs setup
```

### Previous releases

Expand Down

0 comments on commit 9459c8f

Please sign in to comment.