Go to file
Ben Kofman e5ce5c6ccf
Update versions.md (#77)
* Update versions.md

Contributing code link is pointed to same directory (docs), but the contributing document is one directory higher.

Change '.' to '..'

* Update versions.md

* Update versions.md

* Update versions.md

revert changes from last commit
2024-05-29 15:05:52 -05:00
.cargo Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
.github feat-github-policies: Added resourceManagement.yml to .github folder … (#61) 2024-03-05 08:08:55 -08:00
.pipelines Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
cpp Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
docs Update versions.md (#77) 2024-05-29 15:05:52 -05:00
img Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
scripts Fixed $null check for consistency, variable "$sudoOffset" typo (#17) 2024-02-09 11:25:02 -06:00
sudo Fix typo in main.rs comment (#84) 2024-05-29 14:30:41 -05:00
sudo_events Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
tools docs: update tests.ipynb (#79) 2024-05-29 14:30:20 -05:00
win32resources Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
.clang-format Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
.gitignore Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
Building.md Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
CODE_OF_CONDUCT.md Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
CONTRIBUTING.md Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
Cargo.lock Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
Cargo.toml Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00
LICENSE Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
NOTICE.md Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
README.md Update README.md (#76) 2024-05-24 07:30:57 -05:00
SECURITY.md Initial commit to standup Sudo for Windows repo 2024-02-08 10:41:07 -06:00
SUPPORT.md Fix references to the other repo in SUPPORT.md (#13) 2024-02-09 11:23:32 -06:00
enable_sudo.cmd Initial release of the sudo source (#71) 2024-05-22 18:48:06 -07:00

README.md

Sudo for Windows icon Sudo for Windows

Welcome to the repository for Sudo for Windows 🥪. Sudo for Windows allows users to run elevated commands directly from unelevated terminal windows.

The "Inbox" version of sudo is available for Windows 11 builds 26045 and later. If you're on an Insiders build with sudo, you can enable it in the Windows Settings app, on the "Developer Features" page.

Here you can report issues and file feature requests.

Relationship to sudo on Unix/Linux

Obviously, everything about permissions and the command line experience is different between Windows and Linux. This project is not a fork of the Unix/Linux sudo project, nor is it a port of that sudo project. Instead, Sudo for Windows is a Windows-specific implementation of the sudo concept.

As the two are entirely different applications, you'll find that certain elements of the traditional sudo experience are not present in Sudo for Windows, and vice versa. Scripts and documentation that are written for sudo may not be able to be used directly with Sudo for Windows without some modification.

Documentation

All project documentation is located at aka.ms/sudo-docs. If you would like to contribute to the documentation, please submit a pull request on the Sudo for Windows Documentation repo.

Contributing

Check out CONTRIBUTING.md for details on how to contribute to this project.

sudo.ps1

In the meantime, you can contribute to the sudo.ps1 script. This script is meant to be a helper wrapper around sudo.exe that provides a more user-friendly experience for using sudo from PowerShell. This script is located in the scripts/ directory.

Communicating with the Team

The easiest way to communicate with the team is via GitHub issues.

Please file new issues, feature requests and suggestions, but DO search for similar open/closed preexisting issues before creating a new issue.

If you would like to ask a question that you feel doesn't warrant an issue (yet), try a discussion thread. Those are especially helpful for question & answer threads. Otherwise, you can reach out to us via your social media platform of choice:

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.